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译 a F 


正如 我 们 所 看 到 的 ， 以 手机 为 代表 的 移动 通信 设备 的 发 展 日 新 月 异 ， 给 人 们 的 生产 生活 方 
式 带 来 了 单 命 性 的 影响 。 从 上 世纪 90 年 代 初 只 具有 单一 功能 且 使 用 模拟 信号 的 “大 哥 大 ”， 到 
如 今 代 表 了 智能 手机 终端 综合 设计 和 应 用 水 平 的 业界 普 楚 iPhone 4， 都 无 不 彰显 了 技术 和 市 场 的 
力量 。 而 这 一 变革 的 原动力 归根 结 底 就 是 对 目 由 和 开放 的 不 懈 退 求 一 一 技术 的 上 自由， 市 场 的 开 
放 ， 使 更 多 的 人 能 够 加 入 到 这 一 潜力 巨大 的 智能 手机 业务 的 开发 领域 。 由 此 催生 的 多 姿 多 彩 的 
手机 操作 系统 平台 和 五 花 八 门 的 各 类 应 用 软件 ， 带 给 了 我 们 更 多 的 繁荣 和 丰富 的 用 户 体 验 。 而 
Android 手 机 操作 系统 正 是 这 一 开放 平台 的 代表 ， 它 短 短 5、6 年 的 发 展 历 史 已 经 使 得 苹果 公司 大 
为 头痛 ， 不 得 不 派 乔 布 斯 去 上 禹 那儿 寻求 帮助 了 ， 更 逮 论 诺基亚 之 类 抱 残 守 缺 的 徒劳 挣扎 ; 曾 

的 确 ， 现 在 的 Android 借 助 于 Google“ 开 放手 机 联盟 ”的 巨大 影响 ， 由 于 其 开放 性 ， 已 
经 充斥 了 日 第 生活 的 方方面面 。 随 者 Android 设 备 的 进一步 普及 ， 因 其 可 扩展 性 和 便于 携 市 
的 特征 ，Android 智 能 终 疹 正 迅速 地 融入 生活 ， 甚 至 可 以 与 微 博 、EFacebook、Twitter 进 行 无 
颖 连接 。 尤 其 在 移动 健康 监护 领域 ， 已 经 逐渐 众生 出 以 此 为 目的 的 特种 手机 配件 和 应 用 服务 
等 一 系列 新 兴 产 业 。 奎 能 结合 云 计 算 如 火 如 茶 的 发 展 之 势 ， 相 信和 这 将 义 是 一 个 创造 新 的 产业 
增长 点 的 大 好 时 机 。 译 者 近年 来 也 有 仁 参 与 了 与 之 有 关 的 系列 研发 工作 ， 深 知 其 中 甘 盏 ， 因 
此 很 乐意 将 本 书 介 绍 给 广大 读者 ， 来 共同 迎接 新 的 IT 产 业 半 命 的 到 来 。 

本 书 是 一 本 有 关 基 于 Android 手 机 操作 系统 进行 应 用 程序 开发 的 入 门 读物 ， 作 者 Wei-Meng 
Lee 在 移动 操作 系统 平台 的 项 目 开 发 和 培训 上 具有 让 是 的 实践 经 验 。 他 及 用 图 文 并 成 、 上 手 性 
极 强 的 步 步 引 导 的 方式 将 一 个 门外汉 领 入 Android 的 大 干 世 界 的 同时 ， 叉 为 其 展示 了 较为 广阔 的 
视野 ， 避 人 免 了 初学 者 弟 党 具有 的 只 见 树木 不 见 森 林 的 缺憾 ， 塔 称 一 大 特色 。 本 书 从 Android 的 发 
展 沿 单 讲 起 ， 通 过 对 其 中 关键 概念 深入 浅 出 的 介绍 ， 用 大 量 的 示例 说 明了 Android 应 用 程序 的 构 
成 、 表 现形 式 以 及 运行 原理 ， 为 读者 描绘 了 较为 完整 的 Android 开 发 蓝图 。 在 此 基础 上 ，3 引 入 J 了 
一 些 高 级 组 件 和 功能 的 介绍 ， 为 读者 进一步 的 实践 和 开 友 融 价 值 的 应 用 程序 指明 了 方 同 。 除 辅 
以 每 章 课 后 的 练习 使 读者 巩固 所 学 之 外 ， 通 篇 口语 化 的 表达 方式 也 拉 近 了 本 书 与 读者 的 距离 。 
当然 ， 由 于 是 面 同 初学 者 ，Android 本 号 的 体系 结构 和 原理 并 未 过 多 介绍 ， 对 于 想 对 此 有 更 深入 
了 解 的 读者 未 人 免 有 意犹未尽 之 感 ， 同时 ， 也 是 广大 读者 比较 关心 的 ， 对 于 如 何 通过 编写 应 用 程 
序 来 获取 经 济 效 益 ， 本 书 只 是 简单 提 到 了 了 “经典” 方法， 没有 涉及 更 为 灵活 的 技术 手段 ， 略 有 
遗憾 。 当 然 ， 这 也 是 可 以 理解 的 ， 毕 竞 本 书 不 是 一 本 专注 于 市 场 营 销 的 书籍 。 

在 全 书 翻 译 过 程 中 ， 对 于 Android 中 最 重要 的 两 个 概念 一 一 activity 和 intent， 考 虑 到 译本 是 面 
器 国内 读者 的 入 门 读 物 ， 为 了 更 好 地 建立 目 己 的 汉语 语 境 和 术语 体系 并 利于 读者 理解 ， 我 们 统 
一 将 其 分 别 翻译 成 “活动 ”和 “意图 ”。 尤 其 是 在 原理 性 说 明 或 描述 性 段落 中 ,但 是 在 与 代码 
相关 的 上 下 文中 仍旧 保持 原先 的 英文 形式 ， 读 者 阅读 时 请 注意 这 一 点 。 其 他 的 相关 专 有 名 词 也 
作 类 似 处 理 ， 包 括 章 节 标 题 。 

限于 译 者 水 平 ， 详 文 定 有 很 多 不 当 之 处 ， 冤 请 读者 批评 指正 。 


何 晨 光 ” 李 洪 刚 
于 深圳 西 丽 大 学 城 


作者 简介 


Wei-Meng Lee 是 Developer Learning Solutions 公 司 (www.learn2develop.net) 的 创始 人 和 技术 专 
家 ， 这 家 技术 公司 专门 从 事 最 新 移动 技术 的 培训 。Wei-Meng 具 有 多 年 的 培训 经 验 ， 他 的 培训 课 
程 特别 强调 实践 学 习 法 。 这 种 动手 学 习 编 程 的 方法 比 通过 阅读 书籍 、 教 程 和 文档 来 理解 主题 要 
容易 得 多 。 

Wei-Meng4 E Beginning iOS 4 Application Development(Wrox) 等 书 的 作者 。 读 者 可 以 通过 
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Kunal Mittal 是 Sony Pictures Entertainment; ri] [f] 技术 执行 总 监 ， 他 负责 SOA、 Identity 
Management 以 A Content Management! 目 。Kunal 还 是 一 位 帮助 创业 者 确定 技术 战略 、 产 品 路 线 
和 开发 计划 的 企业 家 。 他 一 般 担任 顾问 或 咨询 公司 首席 技术 官 的 职位 ， 并 从 事项 目 经 理 和 拉 术 
架构 师 的 工作 。 

他 已 经 把 写 和 编辑 了 多 本 关于 J2EE、 云 计算 和 移动 技术 方面 的 专车 以 及 多 篇 文章 。 他 拥有 
软件 工程 的 硕士 学 位 ， 还 是 一 名 仪表 飞行 等 级 的 私人 飞行 员 。 


每 次 完成 一 本 书 的 编写 工作 ， 我 总 是 告诉 目 己 这 是 我 写 的 最 后 一 部 书 了 。 因 为 与 书 真 的 是 
一 个 特别 费时 费力 的 工作 。 然 而 ， 当 你 收 到 读者 的 电子 邮件 告诉 你 他 们 从 中 学 到 了 新 的 技术 并 
为 此 表示 感谢 时 ， 所 有 的 挫折 都 烟 消 云 辟 了 。 

果然 ， 当 完成 前 一 本 关于 iOS 编 程 的 书后 ， 我 又 立即 签署 了 另外 一 本 书 的 编写 工作 一 一 这 次 
是 关于 Android 的 。 尽 管 您 在 封面 上 只 能 看 到 作者 的 名 字 ， 但 实际 上 是 更 多 的 幕后 工作 者 才 使 本 
书 的 出 版 成 为 可 能 。 现 在 本 书 已 经 完成 ， 我 要 对 他 们 表示 衷心 的 感谢 。 

首先 ， 特 别 感谢 本 书 的 编辑 Ami Sullivan， 同 她 合作 一 直 都 很 愉快 。 难 以 置信 的 是 我 们 在 一 
个 非常 短 的 时 期 内 (仅仅 一 年 ) 已 经 合作 过 3 本 书 ， 本 书 是 第 4 本 了 ! 当 我 得 知 Ami 将 成 为 我 的 编辑 
时 ， 我 就 知道 这 个 项 目 将 顺利 完成 。 谢 谢 Ami 的 悉心 指导 ， 谢 谢 Ami 在 本 书 看 起 来 永远 不 能 按期 
完成 的 那 段 时 间 所 具有 的 耐心 。 

还 不 能 态 记 的 是 那些 幕后 的 英雄 : 文字 编辑 Luann Rouff 和 技术 编辑 Kunal Mittal。 他 们 在 编 
辑 本 书 时 所 具有 的 锐利 眼光 ， 保 证 了 每 一 句 话 的 准确 性 一 一 无 论 是 在 语法 方面 还 是 技术 方面 。 
Luann 和 Kunal， 谢 谢 你 们 ! 

我 还 要 借 此 机 会 同 我 在 MobiForge.com 的 编辑 Ruadhan ODonoshue 表 示 感 谢 ， 他 一 直 对 我 的 
写作 非常 支持 。 他 总 是 接受 我 的 想法 并 且 在 我 的 进度 落后 时 给 予 理解 。Ruadhan， 谢 谢 您 维护 了 
这 么 棒 的 一 个 网 站 。 

最 后 ， 但 并 非 最 不 重要 的 一 点 是 ， 我 要 感谢 我 的 父母 以 及 妻子 Sze Wa 所 给 予 我 的 全 力 文 
持 。 在 我 写作 本 书 的 那 段 时 间 ， 他 们 无 私 地 调整 日 己 的 日 程 安 排 来 迁就 我 。Sze Wa 在 我 为 满足 
期 限 要 求 拼 命 工 作 的 无 数 个 夜晚 总 是 一 直 陪 我 熬夜 ， 为 此 我 非常 感激 。 男 外 ， 我 们 可 爱 的 小 狗 
OokKii， 谢 谢 你 陪伴 奢 我 们 (如 果 想 知道 Qokii 是 谁 ， 读 者 可 以 在 本 书 中 找到 它 的 两 张 照 片 。 找 到 
它们 束 作 为 我 留 给 你 们 的 额外 练习 吧 )。 
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我 最 开始 玩 Android SDK 是 在 其 正式 版 本 1.0 发 布 以 前 。 那 时， 工具 还 不 完善 ，SDK 中 的 API 
不 稳定 ， 文 档 也 很 缺乏 。 经 过 两 年 半 时 间 的 快速 发 展 ， 现 在 的 Android 已 经 成 为 一 个 和 iPhone 相 
比 坚 不 逊色 的 强大 的 移动 操作 系统 。 由 于 经 历 过 Android 成 长 的 所 有 痛 震 ， 我 想 现 在 是 开始 学 习 
Android 编 程 的 最 好 时 机 一 一 API 已 经 稳定 ， 工 具 也 有 了 改善 。 但 是 仍 存 在 一 个 挑战 : 对 许多 人 来 
说 ， 入 门 仍 是 一 个 可 望 而 不 可 及 的 目标 。 这 一 挑战 在 我 脑海 里 徘徊 许久 ， 也 成 为 了 我 写本 书 的 动 
力 ， 它 也 许可 以 给 Android 初 级 程序 员 带 来 益处 ， 并 使 他 们 能 够 逐步 编写 更 复杂 的 应 用 程序 。 

由 于 本 书 是 写 给 Android 初 级 开发 人 员 的 ， 为 的 是 使 他 们 能 够 快速 上 手 ， 因 此 我 以 线性 方式 
涵盖 了 必要 的 主题 ， 这 样 可 以 使 您 建立 起 自己 的 知识 体系 而 不 会 被 细节 淹没 。 我 采取 的 哲学 观 
点 是 : 最 好 的 学 习 方 法 是 实践 一 一 因此 ， 每 一 章 的 “ 试 一 试 ” 部 分 将 首先 教 您 如 何 构建 一 些 东 
西 ， 然 后 解释 其 工作 原理 。 

尺 管 Android 编 程 是 一 个 宏大 的 主题 ， 但 本 书 要 实现 三 重 目 标 : 帮助 读者 从 最 基本 的 原理 入 
手 ， 使 谈 者 理解 SDK 的 底层 架构 以 及 领会 事情 要 按 特 定 方式 完成 的 原因 。 本 书 超越 了 目前 任何 
一 本 面面俱到 的 有 关 Android 编 程 的 书籍 的 范围 ， 但 我 确信 当 您 阅读 完 此 书 (并 做 了 练习 ) 之 后 ， 
将 有 充分 的 准备 来 应 对 下 一 个 Android 编 程 的 挑战 。 
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本 书 针 对 的 是 打算 使 用 Google 的 Android SDK 来 开发 应 用 程序 的 Android 初 级 开发 人 员 。 为 
了 从 本 书 中 真正 获 益 ， 您 应 该 在 编程 方面 具有 一 些 背 景 知识 ， 并 且 至 少 熟 悉 和 面 同 对 象 编 程 的 概 
您 。 如 果 对 Java(Android 开 发 所 用 的 语言 ) 一 无 所 知 ， 那 么 您 也 许 应 该 首先 学 习 一 门 Java 编 程 谍 
程 ， 或 者 阅读 有 关 Java 编 程 方面 的 优秀 书籍 。 以 我 的 经 验 ， 如 果 您 已 经 了 解 C# 或 VB.NET， 学 习 
Java 束 比较 轻松 ; 只 要 按照 “ 试 一 试 ” 的 步骤 就 可 以 使 您 的 尝 习 过 程 顺 利 进行 。 

对 于 那些 对 所 有 编程 概念 都 一 无 所 知 的 人 来 说 ， 我 知道 开 友 移动 应 用 程序 并 赚 到 钱 是 很 有 
诱惑 力 的 。 然 而 ， 在 符 试 本 书 的 示例 之 前 ， 我 想 首 先 学 习 一 些 基 本 的 编程 知识 才 是 更 好 的 看 


注意 : 本 书 中 讨论 的 所 有 示例 均 使 用 Android SDK 2.3 版 本 编写 和 测试 。 尽 
管 我 们 已 经 努力 保证 本 书 中 所 有 用 到 的 工具 都 是 最 新 的 ， 但 当 您 阅读 本 书 时 ， 

还 是 很 可 能 有 更 新 版 本 的 工具 可 用 。 如 果 是 这 样 ， 某 些 指示 和 /或 屏幕 截图 会 
有 少许 不 同 。 不 过 ， 任 何 改 变 都 应 是 可 控 的 。 


VI 


Android 编 程 入 门 经 典 


本 书 主要 内 容 


WPM J IEH Android SDK 进 行 Android 编 程 的 基本 概念 ， 共 分 为 11 章 和 3 个 附录 。 

“第 1 章 : Android 编 程 入 门 ” 介 绍 了 Android 操 作 系统 的 基本 概念 和 当前 发 展 状况 。 您 可 以 
了 解 到 Android 设 备 的 各 种 功能 以 及 市 场 上 一 些 比 较 流 行 的 设备 。 还 可 以 学 习 如 何 下 载 和 安装 所 
有 必需 的 工具 来 开发 Android 应 用 程序 并 在 Android 模 拟 器 上 进行 测试 。 

“第 2 章 : 活动 和 意 钢 ”使 您 熟悉 Android 编 程 中 的 两 个 最 重要 的 概念 : 活动 和 意图 。 活 动 
是 Android 应 用 程序 的 构建 块 。 您 将 学 习 如 何 使 用 意图 将 活动 链接 起 来 形成 一 个 完整 的 Android 心 
用 程序 。 意 图 是 链接 活动 的 胶水 ， 也 是 Android 操 作 系 统 的 独特 特征 之 一 。 

“第 3 章 : Android 用 户 界 面 ” 介绍 了 Android 应 用 程序 的 用 户 界 面 的 不 同 组 成 部 分 。 您 将 学 
习 到 用 来 构建 应 用 程序 的 用 户 界面 的 不 同 布局 ， 以 及 当 用 户 和 应 用 程序 交互 时 与 用 户 界面 相关 
联 的 多 种 事件 。 

“第 4 章 : 使 用 视图 设计 用 户 界面 ”介绍 了 可 用 于 构建 Android 用 户 界面 的 各 种 基本 视图 。 
该 章 将 学 习 3 组 主要 的 视图 : 基本 视图 、 选 取 融 视图 和 列表 视图 。 

“第 5 章 : 使 用 视图 显示 图 片 和 菜单 ”继续 研究 视图 。 您 将 了 解 到 如 何 使 用 不 同 的 图 像 视 
图 来 显示 图 像 ， 以 及 在 应 用 程序 中 显示 选项 和 上 下 文 菜单 。 该 章 最 后 将 额外 介绍 一 些 很 酷 的 视 
图 ， 可 以 用 它们 来 为 您 的 应 用 程序 锦上添花 。 

“第 6 章 : 数据 持久 化 ” 教 您 如 何在 Android 应 用 程序 中 保存 或 存储 数据 。 除 了 学 习 使 用 不 
同 的 技术 来 存储 用 户 数 据 外 ， 您 将 学 习 到 文件 操作 以 及 如 何 把 文件 保存 到 内 部 或 外 部 存储 器 (SD 
卡 ) 上 。 此 外 ， 还 将 学 习 到 如 何在 Android 应 用 程序 中 创建 和 使 用 SQLite 数 据 库 。 

“第 7 章 : 内 容 提 供 者 ”讨论 了 在 Android 设 备 的 不 同 应 用 程序 间 如 何 共 享 数据 。 您 将 学 习 
如 何 使 用 内 容 提供 者 并 自己 创建 一 个 。 

“第 8 章 : 消 奶 传递 和 联网 ”研究 了 移动 编程 中 最 有 趣 的 两 个 主题 一 一 发 送 SMS 消 恩 和 网 络 
编程 。 您 将 学 习 如 何以 编程 方式 发 送 和 接收 SMS 消 息 ， 如 何 连接 到 Web 服 务 器 来 下 载 数据 。 最 
后 ， 还 将 了 解 在 Android 应 用 程序 中 是 如 何 访问 Web 服 务 的 。 

“第 9 章 : 基于 位 置 的 服务 ”描述 了 如 何 使 用 Google Maps 来 构建 基于 位 置 的 服务 应 用 程 
序 。 您 还 将 学 习 到 如 何 获取 地 理 位 置 数据 并 在 地 图 上 显示 该 位 置 。 

“第 10 章 : 开发 Android 服 务 ” 将 回 您 展示 如 何 使 用 服务 来 编写 应 用 程序 。 服 务 是 运行 于 后 
台 且 没有 用 户 界 面 的 应 用 程序 。 您 将 了 解 如 何在 一 个 单独 的 线程 中 以 异步 方式 运行 您 的 服务 ， 
以 及 活动 与 之 通信 的 方法 。 

“第 11 章 : 发 布 Android 应 用 程序 ”讨论 了 您 在 准备 好 发 布 Android 应 用 程序 时 可 以 采用 的 不 
同方 法 。 您 还 将 了 解 到 在 Android Market 上 发 布 并 出 售 应 用 程序 的 步骤 。 

“附录 A: 使 用 Eclipse 进行 Android 开 发 ”简要 概述 了 Eclipse 中 的 许多 功能 。 

“附录 B: 使 用 Android 模 拟 器 ”提供 了 有 关 使 用 Android 模 拟 器 进行 应 用 程序 测试 方面 的 一 些 
提示 和 技巧 。 

“附录 C: 练习 答案 ”包含 了 每 章 最 后 的 练习 的 答案 。 


本 书 的 结构 


本 书 将 学 习 Android 编 程 的 任务 分 解 为 否 干 个 更 小 的 环节 ， 使 您 能 够 在 钻研 更 局 级 的 内 容 之 


Di} 


前 消化 每 一 个 主题 。 

如 果 您 对 于 Android 编 程 完全 是 个 新 手 ， 那 就 自 先 从 第 1 草 开始 。 一 旦 熟悉 了 基本 概念 ， 束 
可 以 转 到 附录 去 阅读 更 多 有 关 Eclipse 和 Android 模 拟 器 的 知识 。 当 完成 这 些 之 后 ， 可 以 再 从 第 2 
章 继续 ， 并 按部就班 地 学 习 更 高 级 的 主题 。 

本 书 一 大 特色 就 是 每 章 的 所 有 示例 代码 都 独立 于 先前 章节 所 讨论 的 内 容 。 这 样 ， 您 可 以 灵 
活 地 转 入 到 所 感 兴趣 的 主题 并 按照 “ 试 一 试 ” 的 项 目 内 容 开 始 练习 。 


使 用 本 书 的 前 提亲 件 


本 书 中 的 所 有 示例 都 在 Android 模 拟 器 (作为 Android SDK 的 一 部 分 ) 上 运行 。 当 然 ， 为 了 从 本 
书 中 得 到 更 多 收获 ， 拥 有 一 个 真实 的 Android 设 备 还 是 很 有 益 的 (尽管 这 不 是 绝对 必要 的 )。 


源 代码 


由 于 需要 从 头 至 尾 运 行 本 书 中 的 示例 ， 您 可 以 选择 手工 键入 全 部 代码 或 者 使 用 本 书 配套 的 

源 代码 文件 。 本 书 用 到 的 所 有 源 代 人 码 文 件 在 www.wrox.com 上 均 可 下 载 。 在 这 个 网 站 上 ， 直 接 找 

到 本 书 的 书 名 (使 用 搜索 框 或 从 书 名 列表 选择 )， 然 后 在 本 书 的 详细 页 面 上 点 击 Download Code 链 

所 需 项 目 文件 的 名 称 将 出 现在 一 个 代码 注释 中 ， 它 位 于 “ 试 一 试 ” 内 容 的 开头 部 分 ， 像 
代码 片段 的 文件 名 称 


代码 下 载 完成 后 ， 使 用 您 熟悉 的 讨 缮 工 具 解 床 缩 。 或 者 转 到 Wrox 的 代 但 下 载 主页 www. 
wrox.com/dynamic/download.aspx 上奏 看 本 书 以 及 其 他 所 有 Wrox 书 籍 的 可 用 代 但 。 

读者 也 可 从 本 书 的 文 持 网 站 http:Wwww.tupwk.com.cn/downpasge 上 下 载 本 书 源 代码 。 对 于 本 
书 如 有 任何 意见 和 建议 ， 请 发 送 邮 件 全 wkservice@vip.163.com。 
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本 章 将 介绍 以 下 内 容 

€ Android 简 介 

€ Android 版 本 及 其 功能 集 

€ Android} 

e 市 场 上 的 各 种 Android 设 备 

€ Android Market 应 用 程序 商店 

e ”如 何 获得 开发 Android 应 用 程序 的 工具 和 SDK( 软 件 开发 工具 包 ) 


e 如 何 开发 您 的 第 一 个 Android 应 用 程序 

欢迎 阅读 本 书 ! 既然 您 手中 拿 看 这 本 书 (或 正在 您 的 最 新 移动 设备 上 阅读 它 )， 那 就 说 明 您 对 
学 习 如 何 为 Android 平 台 编 写 应 用 程序 很 感 兴趣 一 一 现在 就 是 学 习 Android 应 用 程序 开发 的 最 佳 时 
机 。 移 动 应 用 市 场 正 在 迅速 增长 ， 最 近 的 市 场 调查 显示 ，Android 已 经 超越 iPhone 在 美国 智能 手 
机 市 场 占据 第 二 的 位 置 。 目 前 第 一 名 的 节 洽 属于 Research In Motion(RIM)，Apple 的 iPhone 是 第 
三 名 。 就 在 您 阅读 本 书 的 时 候 ，Android 很 有 可 能 已 经 成 为 美国 第 一 大 智能 手机 平台 ， 而 且 您 也 
许 正在 最 新 的 一 款 Android 设 备 上 阅读 本 书 。 

是 什么 使 得 Google 在 2005 年 买 入 的 这 个 相对 不 那么 知名 的 操作 系统 在 今天 却 如 此 受 欢迎 
Uc? 它 又 提供 了 哪些 功能 ?本 章 将 介绍 Android 到 旗 是 什么 ， 以 及 是 什么 让 开 上 用 人 员 和 设备 制造 
商都 有 如 此 大 的 兴趣 。 您 也 将 开始 开 友 您 的 第 一 个 Android 应 用 程序 ， 并 学 会 如 何 获 得 必要 的 工 
具 并 对 其 设置 。 在 本 章 结尾 ， 您 将 具备 进一步 探索 更 尖 端 的 技术 和 技巧 以 开发 您 的 下 一 个 杀手 
级 的 Android 应 用 程序 所 寅 的 基础 知识 。 


1.1 Android 简 介 


Android 是 一 蒜 基 于 Linux 修 订 版 本 的 移动 操作 系统 。 它 最 初 是 由 同名 的 Android 有 限 公 司 作 
为 进入 移动 市 场 的 战略 的 一 部 分 于 2005 年 开发 的 。Google 收 购 了 Android 公 司 ， 并 接管 了 它 的 开 
发 工作 (包括 整个 开发 团队 )。 

Google 要 求 Android 系 统 是 开放 和 免费 的 。 因 此 ， 大 部 分 Android 代 但 在 Apache License 开 源 
协议 下 都 公开 了 ， 这 意味 着 任何 想 使 用 Android 的 人 都 可 以 下 载 Android 的 全 部 源 代码 。 此 外 ， 供 
应 商 (特别 是 便 件 制造 商 ) 可 以 添加 他 们 目 己 专 有 的 Android 扩 展 ， 通 过 定制 Android 以 区 别 于 其 他 


Android 编 程 入 门 经 典 


广 商 的 产品 。 这 一 简单 的 开发 模型 使 Android 非 常 有 吸引 力 ， 并 因此 引起 了 许多 供应 商 的 兴趣 。 
Apple 公 司 iPhone 产 品 的 巨大 成 功 彻底 改变 了 智能 手机 产业 ， 这 深 深 影响 到 了 诸如 摩托 罗拉 和 索 
爱 这 一 类 多 年 只 开发 自己 的 移动 操作 系统 的 公司 。 当 iPhone 发 布 时 ， 这 些 大 部 分 的 厂商 不 得 不 
争 相 寻找 振兴 自己 产品 的 新 出 路 。 他 们 将 Android 视 为 一 种 解决 方案 一 一 继续 设计 自己 的 硬件 ， 
同时 将 Android 用 作 操 作 系 统 并 增强 其 功能 。 

使 用 Android 的 主要 优势 是 它 提供 了 统一 的 应 用 程序 开发 方法 。 开 发 人 员 只 需要 为 Android 进 
行 开 发 ， 开 发 出 的 应 用 程序 可 以 运行 在 许多 不 同 的 设备 上 ， 只 要 这 些 设备 用 的 是 Android 系 统 。 
在 智能 手机 界 ， 应 用 程序 是 成 功 链 中 的 最 重要 一 环 。 因 此 ， 为 了 应 对 已 经 占据 大 量 应 用 程序 市 
场 的 iPhone 市 来 的 已 大 神 击 ， 设 备 制 造 商 对 Android 寄 子 了 厚望 。 


1.1.4 Android 版 本 


自首 次 发 布 以 来 ，Android 己 历经 了 相当 多 数量 的 更 新 版 本 。 表 1-1 列 出 了 Android 的 不 同 版 
本 及 其 相应 代号 。 
表 1-1 Android 版 本 简 史 


Android 版 本 发 布 日 期 代 号 

1.1 2009 人 年 2 月 9 日 

1.5 2009 年 4 月 30 日 Cupcake( 纸 杯 重 粒 ) 
1.6 20094F9 H 15H Donut(^f hi fal) 
2.0/2.1 2009410 H26 H Eclair( 长 松 饼 ) 

22 2010 年 5 月 20 日 Froyo( 冻 酸奶 ) 

2.3 2010 征 12 月 6 日 Gingerbread( Z Df) 
3.0 尚未 确定 (截止 到 写作 本 书 时 ) Honeycomb( 蜂 间 ) 


1.1.2 Android 功 能 


鉴于 Android 的 开源 以 及 制造 商 可 对 其 目 由 定制 的 特点 ， 因 此 没有 国定 的 软 便 件 配置 。 然 
i. 


Android 本 身 文 持 如 下 功能 : 

e 存储 一 一 使 用 SQLite( 轻 量 级 的 关系 数据 库 ) 进 行 数据 存储 ， 第 6 章 将 对 数据 存储 进行 详 
细 讨 论 。 

e ”连接 性 一 一 支持 GSM/EDGE、IDEN、CDMA、EV-DO、UMTS、Bluetooth( 包 括 A2DP 和 
AVRCP)、WiFi、LTE 和 WiMAX。 第 8 章 将 详细 讨论 联网 。 

@ ”消息 传递 一 一 支持 SMS 和 MMS， 也 在 第 8 章 进 行 详细 探讨 。 

© Webi zy 基于 开源 的 WebKit， 并 集成 Chrome 的 V8 JavaScript | €. 

e 媒体 支持 一 一 支持 以 下 媒体 H.263、H.264( 在 3GP 或 MP4 容 器 中 )、MPEG-4 SP, AMR, 

AMR-WB( 在 3GP 容 器 中 )、AAC、HE-AAC( 在 MP4 或 3GP 容 器 中 )、MP3、MIDI、Ogg 

Vorbis、WAV、JPEG、PNG、GIF 和 BMP.。 

人 硬件 支持 一 一 加 速度 传感器 、 摄 像 头 、 数 字 式 罗盘 、 接 近 传 感 器 和 全 球 定 位 系统 (GPS)。 

多 点 触摸 一 一 文 持 多 点 触摸 屏 倚 。 

多 任务 一 一 文 持 多 任务 应 用 。 

Flash x: £———Android 2.3 支 持 Flash 10.1. 

tethering 一 一 文 持 作 为 有 线 /无 线 热点 实现 Internet 连 接 共 享 。 
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1.1.3 Android 架 构 


为 了 理解 Android 的 工作 方式 ， 可 以 参看 图 1-1， 该 图 描述 了 构成 Android 操 作 系 统 (OS) 的 各 


包 


序 框架 


应 用 程 
adele LLLA 


| RURTEEBR 资源 管理 器 位 置 管理 器 通知 管理 器 


Android 运 行 时 
核心 库 | 


Dalvik 虚 拟 机 


键盘 驱动 程 


图 1-1 


Android 操 作 系统 大 致 可 以 在 4 个 主要 层面 上 分 为 以 下 5 个 部 分 : 


Linux 内 核 一 一 这 是 Android 所 基于 的 核心 。 这 一 层 包 括 了 一 个 Android 设 备 的 各 种 硬件 组 件 
的 所 有 低层 设备 驱动 程序 。 

库 一 一 包括 了 提供 Android 操 作 系 统 的 主要 功能 的 全 部 代码 。 例 如 ，SQLite 库 提供 了 支持 应 
用 程序 进行 数据 存储 的 数据 库 。Webkit 库 为 浏览 Web 提 供 了 众多 功能 。 

Android 运 行 时 一 一 它 与 库 同 处 一 层 ， 提 供 了 一 组 核心 库 ， 可 以 使 开发 人 员 使 用 Java 编 程 语 
言 来 写 Android 应 用 程序 。Android 运 行 时 还 包括 Dalv 还 虚拟 机 ， 这 使 得 每 个 Android 应 用 程序 
都 在 它 自 己 的 进程 中 运行 ， 都 拥有 一 个 上 自己 的 Dalv 还 虚拟 机 实例 (Android 应 用 程序 被 编译 成 
Dalvik 可 执行 文件 )。Dalvik 是 特别 为 Android 设 计 ， 并 为 内 存 和 CPU 受 限 的 电池 供电 的 移动 
设备 进行 过 优化 的 专门 的 虚拟 机 。 

应 用 程序 框架 一 一 对 应 用 程序 开发 人 员 公 开 了 Android 操 作 系 统 的 各 种 功能 ， 使 他 们 可 以 在 
应 用 程序 中 使 用 这 些 功 能 。 

应 用 程序 一 一 在 这 个 最 顶层 中 ， 可 以 找到 Android 设 备 自 带 的 应 用 程序 (例如 电话 、 联 系 人 、 
浏览 器 等 )， 以 及 可 以 从 Android Market 应 用 程序 商店 下 载 和 安装 的 应 用 程序 。 您 所 写 的 任何 
应 用 程序 都 处 于 这 一 层 。 
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1.4.4 市场 上 的 Android 设 备 


Android 设 备 有 各 种 样式 和 大 小 。 截 至 2010 年 11 月 
底 ，Android 操 作 系统 可 以 文 持 如 下 类 型 的 设备 : 
智能 手机 
平板 电脑 
电子 阅读 器 
上 网 本 
MPATE ji os 
互联 网 电视 
而 您 目前 很 可 能 已 经 至 少 拥 有 其 中 一 种 设备 。 图 1-2 
( 顺 时 针 ) 展 示 f Samsung Galaxy S, HTC Desire HD 以 及 
LG Optimus One 智 能 手机 。 
制造 商都 趋 之 奋 警 的 另 一 类 流行 的 设备 是 平板 电脑 。 
平板 电脑 的 尺寸 通 单 是 7 英寸 大 小 (对 角 线 长 度 )。 疼 1-3 展 示 
T Samsung Galaxy Tab 和 Dell Streak(5 英 寸 的 平板 手机 )。 
除了 智能 手机 和 平板 电脑 外 ，Android 也 开始 出 现 
在 专用 设备 中 ， 如 电子 书 阅 读 器 。 图 1-4 展 示 了 一 款 运行 图 12 
Android 操 作 系 统 的 彩色 电子 书 阅 读 器 产品 一 一 Barnes & Noble 公 司 的 NOOKcolor。 
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1-3 1-4 
UR T IXE, Androidth E ÈRA SEAZA. 3m 3.7: n] People of Lava 开 发 
本 一 于 基于 Android 的 电视 机 ， 名 为 Scandinavia， 如 图 1-5 所 示 。 
Google 还 涉足 了 基于 Android 的 专 有 的 智能 电视 平台 ， 并 和 诸如 英特尔 、 索 尼 、 罗 技 等 公司 
进行 共同 开发 。 图 1-6 展 示 了 索尼 公司 的 Google 电 视 。 
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| twitter 


z 
[A mees | . Jennytuski Meet me at àth and Broadway. 


e jennytuski Watching the new episode of Community on 
| NBC. It rarka! 
e lennytuski ] love ice cream. Any kind. Bring it. 
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图 1-5 


1.1.5 Android Market 


如 前 所 述 ， 决 定 一 个 智能 手机 平台 成 功 的 主要 因素 之 一 是 支持 它 的 应 用 程序 。 从 iPhone 的 
成 功 可 以 清楚 地 看 出 ， 应 用 程序 在 决定 一 个 新 的 平台 是 成 功 还 是 失败 方面 扮演 了 一 个 非常 关键 
的 角色 。 此 外 ， 使 这 些 应 用 程序 能 为 广大 用 户 访问 也 是 极为 重要 的 。 

因此 ， 在 2008 年 8 月 ，Google 宣 布 将 在 同年 10 月 份 为 用 户 提供 一 个 适用 于 Android 设 备 的 在 
线 应 用 程序 商店 : Android Market。 使 用 预 装 于 Android 设 备 上 的 Market 应 用 程序 ， 用 户 可 以 很 方 
便 地 把 第 三 方 应 用 程序 直接 下 载 到 他 们 的 设备 上 。 付 费 和 免费 的 应 用 程序 在 Android Market 上 都 
是 受 支 持 的 ， 不 过 付费 的 应 用 程序 由 于 法 律 问题 只 提供 给 某 些 国家 的 用 户 。 

同样 ， 在 一 些 国 家 ， 用 户 可 以 从 Android Market 购 买 付费 的 应 用 程序 ， 但 开发 人 员 不 能 在 该 
国 销售 。 例 如 ， 在 写作 本 书 时 ， 印 度 的 用 户 可 以 从 Android Market 购 买 应 用 程序 ， 但 印度 的 开发 
人 员 却 不 能 在 Android Market 上 出 售 应 用 程序 。 相 反 的 情况 也 可 能 是 存在 的 。 例 如 ， 韩 国 的 用 户 
不 能 购买 应 用 程序 ， 但 娠 国 的 开发 人 员 可 以 在 Android Market 上 出 售 应 用 程序 。 

第 11 章 讨论 了 更 多 有 关 Android Market 的 内 容 ， 以 及 如 何在 上 面 出 售 上 自己 的 应 用 程序 。 


1.2 EMELE 


赋 然 已 了 解 了 Android 的 概念 和 其 功能 集 ， 您 也 许 淘 望 杀 卓 动手 试 一 试 ， 并 开始 写 些 应 用 程 
序 。 然 而 ， 在 您 号 第 一 个 应 用 程序 之 证， 需要 下 载 所 需 的 工具 和 SDK。 

对 于 Android 开 发 ， 可 以 使 用 Mac、Windows PC 或 Linux 机 器 。 所 有 必需 的 工具 都 可 以 通过 
网 络 免费 下 载 。 除 了 少数 需要 访问 人 硬件 的 例子 以 外 ， 本 书 提供 的 大 多 数 例 子 都 可 以 在 Android 模 
拟 器 中 运行 得 很 好 。 本 书 中 ， 我 将 使 用 运行 Windows 7 操作 系统 的 计算 机 来 演示 所 有 的 代码 示 
例 。 如 果 您 用 的 是 Mac 或 Linux 计 算 机 ， 除 了 存在 一 些 细微 的 送别 ， 屏 攻 截 图 应 该 是 很 相似 的 ， 
您 应 该 可 以 坚 无 困难 地 按照 本 书 的 指导 来 练习 。 

那么 ， 让 我 们 开始 有 趣 的 学 习 之 旅 吧 ! 


Java JDK 


Android SDK 使 用 Java SE 开 发 工具 包 (JDK)。 因 此 , 如 果 您 的 计算 机 上 没有 安装 JDK， 
那么 应 该 通过 www.oracle.com/technetwork/java/javase/downloads/index.html 地 址 下 载 并 在 
进入 下 一 小 节 前 进行 安装 。 
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1.2.1 Eclipse 


JF RAEM N H FEIF B] 98 — 2 DAE TR ST APR BRIDE). W 
Android 来 说 ， 推 荐 使 用 Eclipse。 它 是 一 个 多 语言 的 软件 开发 环境 ， 
有 一 个 可 扩展 的 插件 系统 。 通 过 它 可 以 用 Java、Ada、C、C++、 
COBOL、Python 等 语言 开发 各 种 类 型 的 应 用 程序 。 

对 于 Android 的 开发 ， 要 下 载 Eclipse IDE for Java EE Developers 


(www.eclipse.org/downloads/packages/eclipse-1de-]ava-ee-developers/ | configuration 
heliossr1)。 目 前 有 6 个 版 本 可 用 : Windows(32 位 和 64 位 )、Mac OS X i dropins 


出 features 


(Cocoa 32 和 64) 以 及 Linux (32 位 和 64 位 )。 只 要 选择 与 您 的 操作 系统 相 li p 
对 应 的 那个 版 本 进行 安装 即 可 。 本 书 所 有 示例 均 使 用 Windows 平 台 下 J plugins 


的 32 位 版 本 的 Eclipse 进行 过 测试 。 deem 
下 载 Eclipse IDEJ, WH A R (eclipse LK AEE $1—4 c fF 3 UNE 


F , 比如 C:\Android\。 A 1-75 不 T eclipse X: fr Je 的 内 Š eclipse,exe 
£* | eclipse.ini 
1.2.2 Android SDK —— 
EB) epI-v10.html 
e notice.html 


接 下 来 需要 和 下载 的 一 个 重要 软件 日 然 是 Android SDK. 


Android SDK 包 含 了 一 个 调试 器 、 库 、 一 个 模拟 器 、 文 档 、 示 例 « [mg 

代码 和 教程 。 k 13 items 
nJ DJ MK http://developer.android.com/sdk/index.html F ZX Android 

SDK. 


一 旦 SDK 下 载 完 成 ， 将 其 内 容 (android-sdk-windows 文 件 夹 ) 解 压 到 
C:\Android\ 文 件 夹 下 ， 或 者 任意 一 个 已 经 创建 好 的 文件 夹 下 。 


1.2.3 Android 开 发 工具 


用 于 Eclipse 的 Android 开 发 工具 (Android Development Tools，ADT) 插 件 是 对 Eclipse IDE 的 扩 - 
展 ， 用 以 文 持 Android 应 用 程序 的 创建 和 调试 。 使 用 ADT， 可 以 在 Eclipse 中 做 如 下 工作 : 

@ 创建 新 的 Android 应 用 程序 项 目 

@ 访问 Android 模 拟 器 和 设备 的 存 取 工 具 

e 编译 和 调试 Android 应 用 程序 

@ 将 Android 应 用 程序 导出 到 Android 包 (APK) 

e 创建 数字 证 书 来 对 APK 进 行 代码 签名 

为 了 安装 ADT， 上 前 先 须 双击 eclipse 文 件 夹 下 的 eclipse.exe 文 件 ， 局 动 Eclipse。 

当 Eclipse 首 次 司 动 时 ， 系 统 将 提示 一 个 文件 夹 用 作 您 的 工作 区 。 在 Eclipse 中 ， 工 作 区 是 一 
个 用 于 存储 所 有 项 目的 文件 夹 。 采 用 默认 的 建议 ， 并 单 击 OK 按钮 。 

一 旦 Eclipse 局 动 和 运行 后 ， 选 择 Help | Install New Software... "f Zu (ar Éd1-8Przn.). 

在 出 现 的 Install 窗 口中 的 文本 框 内 输入 http://dl-ssl.google.com/android/eclipse( 如 图 1-9 所 示 )， 
接着 单 击 Add... 按 钮 。 
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Available Software 
Checkthe tems that you wish to install. 


Work with: — http://dl-ssl.gonglecom/andraid/eclipse 


Find more software by working with the "Available Software Sites" preferences. 


type filter text 
Mame 
J00 Developer Tools 


Dynamic Help Details 


Key Assist... Ctrl+Shift+L 

Tips and Tricks Show only the latest verzionz of available software Hide iteme that are already installed 
Report Bug or Enhancement. Group items by category What is already installed? 

Cheat Sheets.. Contact all update sites during install to find required software 


Check for Updates 
Install New Software. 
Eclipse Marketplace... 


About Eclipse 


图 1-8 1-9 
稍 候 ， 您 将 看 到 在 窗口 的 正中 央 显 示 出 Developer Tools 项 (如 图 1-10 所 示 )。 展 开 后 ， 显 示 出 
以 下 内 容 : Android DDMS, Android Development Tools 和 Android Hierarchy Viewer。 全 选 并 单 
击 Next 按 钮 。 


| Available Software 
Check the items that you wish to install. 


Work with: http://dl-ssl.google.com/android/eclipse/ 


| [type filter tæt — 


|, Name Version 
| 4 [V] 908 Developer Tools 
($$. Android DDMS 8.0.1.201012062107-82219 
($3. Android Development Tools 8.0.1./201012062107-82219 
Fr Android Hierarchy Viewer 8.0.1.v201012062107 -82219 


Show only the latest versions of available software | |Hide items that are already installed 
Group items by category What is already installed? 
Contact all update sites during install to find required software 


图 1-10 
在 看 到 安装 详细 信息 (如 图 1-11 所 示 ) 后 ， 单 击 Next 按 钮 。 
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1| Install Details 
Review the items to be installed. 


Name Version Id 
dp. Android DDMS 8.0.1.v20101206210... com.android.ide.eclipse.ddms.feature.gro... 
G Android Development Tools — 8.0.1./20101206210.. com.android.ide.eclipse.adt.feature.group | | 由 
号 Android Hierarchy Viewer 8.0.1./20101206210...  com.android.ide.eclipse.hierarchyviewer.f... | 


图 1-11 
您 会 被 要 求 查 看 工具 的 许可 证 ， 选 中 接受 许可 协议 的 选项 (如 图 1-12 所 示 )。 单 击 Finish 按 钮 
以 继续 。 


Review Licenses 
Licenses must be reviewed and accepted before the software can be installed. 


Apache License 
Note: jcommon-1 0.12 jar is under the BSD li 


Note: kxml2-2.3.0.jar is under the BSD license 


图 1-12 
Eclipse? JF AIntemet E P 2X; 1-H.JfP3ETT ze C Ed 1-13P 8), KEAT, GRADE. 


第 1 章  AndroidZRfz AT] 


注意 : 如 果 在 下 载 ADT 过 程 中 遇 到 任何 问题 ， 可 以 在 http://developer. 


android.com/sdk/eclipse-adt.html#installine 上 查找 Google 的 帮助 


ADT 安 装 完毕 后 ， 将 会 提示 您 午 局 Eclipse。 章 局 后 选择 Window | Preferences( 如 图 1-14 
PEFR). 


New Editor 


Open Perspective 
I ————s Show View 
| Si Installing Software — 


0 Installing Software 


F 


Customize Perspective.. 
Save Perspective As... 
Reset Perspective... 
Close Perspective 

Close All Perspectives 


Navigation 
j Android SDK and AVD Manager 


| Always run in background 


| Preferences 


1-13 图 1-14 


在 Preferences 窗 口中 选择 Android。 这 时 您 将 会 看 到 有 个 错误 消息 说 SDK 尚 未 安装 (如 图 1-15 
所 示 )， 单 击 OK 按 钮 忽略 该 消息 。 


| | type filter text (9 Value must be an existing directory 


c Android Preferences 

Ant SDK Location: 

Data Management Note: The list of SDK Targets below is only reloaded once you hit 'Apply' or 'OK. 
Help 

Install/Update 

Jaw —— — 
je Ei Android SDK Location - 


The location of the Android SDK has not been setup. Please go to Preferences > 
Android and set it up 


| 
| 
| 
j 
| 
| 
i 


图 1-15 
输入 Android SDK 文 件 夹 的 位 置 ， 本 例 中 为 C:\Android\android-sdk-windows， 然 后 单 击 
OKH o 
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1.2.4 创建 Android 虚 拟 设备 (AVD) 


一 步 是 创建 用 于 测试 Android 应 用 程序 的 AVD。AVD 表 示 Android 虚 拟 设备 (Android Virtual 
Device)。AVD 是 一 个 模拟 器 实例 ， 可 以 用 来 模拟 一 个 真实 的 设备 。 
每 一 个 AVD 包 含 一 个 硬件 配置 文件 、 一 个 到 系统 映像 的 映射 ， 以 及 模拟 存储 器 (例如 安全 数 
T (SD) E). 
您 打算 测试 多 少 个 不 同 配置 的 应 用 程序 ， 就 可 以 创建 多 少 个 AVD。 这 种 测试 对 于 人 确定 应 用 
程序 在 有 痢 不 同 功能 的 不 同 设备 上 运行 时 的 行为 是 很 重要 的 。 


注意 : 附录 B 将 讨论 Android 模 拟 器 的 部 分 功能 。 


为 了 创建 AVD， 和 选择 Window | Android SDK and AVD Manager. 
在 左边 的 窗 格 中 选择 Available packages 选 项 并 在 右边 的 窗 格 中 展开 这 些 包 的 名 称 。 图 1-16 显 
示 了 可 用 来 创建 AVD 的 不 同 的 包 ， 从 而 模拟 不 同 版 本 的 Android 设 备 。 


| 画 Android SDK and AVD Manager 


| SDK Location: CAUsers\Wei-Meng qeu E 2 3\android-sdk- EE 


| Packages available for download 
a El Android Repository 
> [V] Y Android SDK Tools, revision 8 
> [V] # Android SDK Platform-tools, revision 1 
» [vw] 5] Documentation for Android SDK, APIS, revision 1 
» $ SDK Platform Android 2.3, API9, revision 1 
» $ SDK Platform Android 2.2, API 8, revision 2 
» $ SDK Platform Android 2.1, API 7, revision 2 
5 LI SDK Platform Android 2.0.1, API G, revision 1 (Obsolete) 
5 LI SDK Platform Android 2.0, AFI 5, revision 1 (Obsolete) 
> [v] # SDK Platform Android 1.6, API 4, revision 3 
> [V] € SDK Platform Android 1.5, API 3, revision 4 
5 : SDK Platform Android 1.1, API 2, revision 1 (Obsolete) 
> [V] GS Samples for SDK APIS, revision 1 
[v] db Samples for SDK API8, revision 1 
prs Samples for SDK APT7, revision 1 
a 3E Third party Add-ons 
a [v] EIL] Vo add-ons (dl-ssl.google.com) 
; WI a Google APIs by Google Inc, Android APIS, revision 1 
EE B Google APIs by Google Inc., Android APIS, revision 2 
> E] L1 Google APIs by Google Inc., Android API 7, revision 1 
> W|% Google APIs by Google Inc., Android API6, revision 1 (Obsolete) 
> W|% Google APIs by Google Inc., Android APIS, revision 1 (Obsolete) 
”回电 Google APIs by Google Inc., Android API 4, revision 2 
> W|% Google APIs by Google Inc, Android API3, revision 3 
> R| Æ Google Usb Driver package, revision 4 
> R| & Google Market Licensing package, revision 1 
dA FII | "amo Electronics add-ons (innovator.samsungmobile.com) 
> Wm GALAXY Tab by Samsung Electronics, Android APIS, revision 1 


Description 


| Delete Add-on Site... | E Display updates [Rees ideis) (usb Install Selected | | 


图 1-16 


选中 您 的 项 目 所 需 的 相应 工具 、 文 档 和 平台 。 
选择 好 所 需 的 项 后 ， 单 击 Install Selected 按 钮 进行 下 载 。 由 于 从 Google 的 服务 器 上 下 载 比较 
费时 ， 因 此 建议 只 下 载 人 总 需 的 部 分 ， 其 他 的 可 以 等 您 有 时 间 时 再 下 载 。 


注意 : 首先 ， 您 至 少 应 该 选择 最 新 的 SDK 平 台 。 在 写作 本 书 时 ， 最 新 的 


SDK-F 4 X SDK Platform Android 2.3, API 9, revision 1. 


*$$1:€  AndroidZRfz AT] 


每 个 版 本 的 Android 操 作 系 统 由 一 个 API 级 别 号 来 标识 。 例 如 ，Android 2.32: 2 (API 9), 


ifi Android 2.2 是 级 别 8 (API 8) 等 。 对 于 每 一 个 级 别 ， 有 两 个 平台 可 用 。 例 如 ， 级 别 9 提供 了 如 下 


两 个 平台 : 
e SDK Platform Android 2.3 
€ Google 公司 的 Google APIs 


以 上 两 者 的 关键 区 别 在 于 Google APIs 平 台 包 含 了 Google Maps 库 。 因 此 ， 如 果 您 在 编写 需要 
Google Maps 的 应 用 程序 ， 那 么 需要 创建 一 个 使 用 Google APIs 平 台 的 AVD( 更 多 内 容 请 参阅 第 9 章 


“基于 位 置 的 服务 ”)。 
单 击 窗口 左 窗 格 中 的 Virtual devices 项 。 再 单 击 位 于 窗口 右 窗 格 中 的 New... 按 钮 。 


在 Create new Android Virtual Device (AVD) 窗 口中 ， 输 入 如 图 1-17 所 示 的 各 项 内 容 。 完 成 后 


单 击 Create AVD 按 钮 。 


£3 Android SDK and AVD Manager 


Installed packages 
Available packages 


Name: Android 2.3 Emulator 


Target: Android 2.3 - AFI Level 9 - 
SD Card: 
9 Size 


C File | | Browse... 


© Buik-in: 


> Resolution: | 


Property Value 
Abstracted LCD density 160 


| Override the existing AVD with the same name 


ET ET 


图 1-17 
在 这 里 ， 您 已 经 创建 了 一 个 AVD( 简 言 之 ， 一 个 Android 模 拟 器 )， 可 以 用 来 模拟 运行 2.3 版 本 
操作 系统 的 Android 设 备 。 除 了 所 创建 的 AVD 之 外 ， 还 可 以 选择 模拟 具有 SD 卡 和 不 同 屏幕 像素 
密度 和 分 辨 率 的 设备 。 


创建 一 些 具 有 不 同 API 级 别 的 AVD 会 更 好 些 ， 这 样 您 的 应 用 程序 可 以 在 不 同 设备 上 得 到 测 
试 。 图 1-18 给 出 了 这 样 一 个 示例 ， 通 过 创建 多 个 AVD， 从 而 在 大 量 不 同 的 Android 平 台 上 测试 您 
的 应 用 程序 。 
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E -1 


Android SDK and AVD Manager 


Virtual devices 


Available packages 


AVD Name 

*« Android 1.5 Emulator 
"HTC 

s” Android 2.1 Emulator 

se GoogleAPIs 2.1 Emulator 
v» Android 2.7 Emulator 

s EmulatorWithSD 

"v GoogleAPIs 2.2 Emulator 
s WVGAR54 

se samsungGalaxyTab 

= Android 2.3 Emulator 

s" HDScreen 

= Android 2.3 Emulator WithSD 


Target Name 

Android 1.5 

Android 1.6 

Android 2.1-updatel 
Google APIs (Google Inc.) 
Android 2.2 
Google APIs (Google Inc.) 
Google APIs (Google Inc.) 
Google APIs (Google Inc.) 


GALAXY Tab Addon (Samsung Elect... 


Android 2.3 
Android 2.3 
Google APIs (Google Inc.) 


s" A walid Android Virtual Device. m A repairable Android Virtual Device. 


*X An Android Virtual Device that failed to load. Click ‘Details’ to see the error. 


1.2.5 创建 第 一 个 Android 应 用 程序 


在 所 有 的 工具 和 SDK 痢 下 载 和 安装 好 以 后 ， 现 在 是 开动 马达 的 时 候 了 。 和 所 有 的 编程 书 
籍 一 样 ， 第 一 个 示例 是 用 无 所 不 在 的 Hello World 应 用 程序 。 这 将 有 助 于 您 详细 了 解构 成 一 个 


Android 项 目的 不 同 组 件 。 


闲话 少 和 性， 让 我 们 直接 进入 Android 的 世界 ! 


创建 第 一 个 Android 应 用 程序 


e| | Repair... 


Details... 


Start.. 


HelloWorld.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 启动 Eclipse， 选 择 菜 单 File | Project... 创 建 一 个 新 项 目 ( 如 图 1-19 所 示 )。 


Project Window 


Mew 


Open File... 


Close 


Close All 


Save 


| Save As... 


Save All 
Revert 


Move... 

Rename... 

Refresh 

Convert Line Delimiters To 


Print... 
Switch Workspace 
Restart 


Import... 
Export... 


Properties 


Alt- Shift- N + 


Ctrl W 
Ctrl-Shitt-- VV 


Ctri-5 


Cre Shift-5 


Ctrl+P 


k 


Alt-- Enter 


ES JPAProject 

Enterprise Application Project 
Dynamic Web Project 

FIR Projert 

Connector Project 
Application Client Project 
Static Web Project 


JERES 


Session Bean (EJB 3.x) 
Message-Driven Bean (EJB 3.x) 
Entity 

Web Service 

Folder 

File 


& 
E 
Fé 
G 
E 
C3 
LT 


Example... 


$12 Androidi AI 


注意 : 在 创建 了 您 的 第 一 个 Android 应 用 程序 后 ， 以 后 的 Android 项 目 可 以 


| 通过 依次 选择 菜单 项 File | New | Android Project 来 创建 。 


(2) 展开 Android 文 件 来， 选择 Android Project( 如 图 1-20 所 示 )。 
(3) 按 图 1-21 所 示 为 Android 项 目 命名 ， 然 后 单 击 Finish 按 钮 。 


Select a wizard 


Wizards: 


type filter text 
g Jawa Project 
$ Java Project from Existing Ant Buildfile 
ject ng 
Gs Plug-in Project 


b m CVS 
b [2 Eclipse Modeling Framework 


| Package name: 


T New Android Project - 


Mew Android Project 


Creates a new Android Project resource. 


|| Project name HelloWorld 


Contents 

(Q! Create new project in workspace 
(^) Create project from existing source 
Use default location 


Location: | G/Users/Wei-Meng Lee/mynewworkspace/HelloWorld 


| © Create project from existing sample 


Samples: | AccelerometerPlay 
Build Target 


Target Name Vendor 

Android 2.1-upda... Android Open Source Project 
Google APIs 
Android 2.2 
Google APIs Google Inc. 

GALAXY Tab Add... Samsung Electronics Co., Ltd. 
Android 2.3 Android Open Source Project 
Google APIs Google Inc. 


Google Inc. 
Android Open Source Project 


Standard Android platform 2.3 


Properties 


| Application name HelloWorld 


net.learn2develop.HelloWorld 


| [v] Create Activity;  MainActivity 


Min SDK Version: | g | 


| < Back | Net» | o EM 


(4) 此 时 ，Eclipse IDE 应 该 如 图 1-22 所 示 。 


(5) 在 Package Explorer 窗 口 (位 十 Eclipse IDE 的 左边 ) 中 ， 单 击 项 目 中 每 个 项 左 侧 显 示 的 各 种 


注意 : 您 要 在 包 的 名 称 中 至 少 包 含 一 个 句点 (.)。 包 名 称 的 惯例 是 使 用 反 向 
域名 ,项 目 名 称 紧 随 其 后 。 例如， 我 公司 的 域名 是 learn2develop.net， 因 此 我 的 
包 的 名 称 应 该 是 net.learn2develop.HelloWorld。 


祥 涉 ， 展 开 HelloWorld 项 目 。 在 res/layout 文 件 夹 中 ， 双 击 main.xml 文 件 ( 如 图 1-23 所 示 )。 
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File Edit Refactor Run Source  Mavigabe Search Project Window Help 


Ci- H Gg 


EE Problems ru 


- lava - Hello orki're s" laycut/mainaml - Eclipse 


File Edit 
: P3 7 [gl E 


Retactor Run Source  Mavigate 


a E HelloWorld 
FEE sre 
» B netiearn2develpp.HellaWarld 
a d gen [Generated lava Files] 
» BR netlearn2clevel pp. HelloWorld 
4 Bh Android 2.3 
b IT android.jar - CAL 
ia. assets 
"ET 
» (Qm drawable-hdpi 
^ [E drawable-Idpi 
s (f drawable-mdpi 
à > layout 
[H mainaml 


Is ers We- hen g 


o E values 
回 AndroidManifestaml 


By. *- 


Q-Q- Hgg- Apr 
= A)| E Taklit 
d -Akla x ala7 
Find Q| BI k Activate. 
iz. Uncategorized 


(D Connact Mylyn E 
Connect to your tazk and ALM tools. 


HE Qutling 15 - Ea ET 


An outline iz not available. 


^. € Javadoc | [È Declaration 


图 1-22 


Search Project Window Help 
A 要 


= m El mainxml iC 


Bg: 


Editing config: default 


& SurfaceView 

& view 

Ai ViewStuh 

gà WebView 

(& AnalogClock 
(A) Auto ComgleteT 
(B) Button 

(C) CheckBax 

(C) CheckedTextVie 
ae Chronometer 


= jm SO Welcome e 


Cherie 


Tutorials 
Go through tutanals 


Samples 
Try aut ihe samples 


Wonrkhbench 


Go to Ine workbench 


d uM 
[SS aes] (B aam) 


[E] default.properties 
B prequard.cfg 


(D DatePicke- 
(DiasalClock — 7 |^" 
Graphical Layout] mainamÌ 
E Problems Si^, @ Jawadoc | [È Declaration 
D itema 


Description Resource 


图 1-23 


(6) main.xml 文 件 定义 了 应 用 程序 的 用 户 界 面 (UT)。 默认 视图 是 Layout 视 图 ， 以 图 形 化 的 方 
式 显示 了 活动 。 要 修改 该 用 户 界 面 ， 可 单 击 位 于 底部 的 main.xml 选 项 卡 ( 如 图 1-24 所 示 )。 
(7) 把 下 列 粗 体 显示 的 代码 添加 到 main.xml 文 件 中 : 


<?xml version-"1.0" encoding-"utf-8"?- 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:orientation-"vertical" 


android 


android: 


cTextView 


android: 
android: 


android: 


«TextView 
android 


«Button 
android 


android 


:layout width-"fill parent" 


layout height-"fill parent" > 


layout width-"fill parent" 
layout height-"wrap content" 
text-"8string/hello" /> 


:layout width-"filll parent" 
android: 
android: 


layout height- "YHE ap content " 
text-"This is my first Android Application!" /» 


:layout width-"fill parent" 
android: 


layout height-"wrap content" 


:text-"And this is a clickable button!" /» 


«/LinearLayout» 


AndroidZi f£ AT] 


(8) 按 Ctrl+s 组 合 键 保 存 对 项 目的 修改 。 

(9) 现在 可 以 看 手 准备 在 Android 模 拟 器 上 测试 应 用 程序 了 。 在 Eclipse 中 选择 项 目 名 称 并 按 
Fl1 键 。 系 统 将 要 求 您 选择 一 种 方法 来 调试 应 用 程序 。 选 择 如 图 1-25 所 示 的 Android Application, 
并 单 击 OK 按钮 。 


EH Run As 


Select a way to run 'HelloWorld': 
ET Android Application 
Jc) Android JUnit Test 
E] lava Applet 
O Java Application 
Ju JUnit Test 


/> 


Description 


< / LinearL Byouto Runs an Android Application 


Layout | main.xml 


注意 : 有 些 Eclipse 安装 有 个 很 讨厌 的 错误 : 在 创建 一 个 新 项 目 后 ， 当 您 想 
调试 应 用 程序 时 ，Eclipse 报 告 说 项 目 中 包含 错误 。 其 至 在 您 没有 修改 项 目的 任 
何 文件 或 文件 夹 时 也 会 如 此 。 为 了 解决 这 一 问题 ， 可 以 直接 删除 位 于 gen/net. 
learn2develop.HelloWorld 文 件 夹 下 的 R.java 文 件 。Eclipse 将 会 为 您 自动 生成 一 个 
新 的 RR.java 文 件 。 一 旦 做 完 这 一 步 ， 项 目 将 不 再 包含 任何 错误 。 
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(10) 现在 Android 模 拟 器 将 开始 启动 (如 果 模 拟 器 被 锁 住 ， 那 么 需要 首先 滑动 解锁 按钮 解 
锁 )。 图 1-26 显 示 了 运行 于 Android 模 拟 器 上 的 应 用 程序 。 


i 5554:GoogleAPIs 2.2 Emulator 


ES Tail © 8:03 am 


ini is my sen 


1-26 
(11) 单 击 Home 按 钮 (位 于 键盘 上 左下 角 的 房子 图 标 )， 将 显示 主屏 内 容 ( 如 图 1-27 所 示 )。 


Și 5554:GoogleAPIs 2.2 Emulator 


DEL 
seelieh iih a 
an sr m Pr 


(12) 单 击 应 用 程序 的 启动 器 图 标 来 显示 已 安装 到 设备 上 的 应 用 程序 列表 。 注 意 ，HelloWorld 
现在 已 安装 在 应 用 程序 启动 器 中 (如 图 1-28 所 示 )。 
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| '* 5554:GoogleAPIs 2.2 Emulator 


eA] 49 8:06 An 


Camera 


£ 


Dev Tools 


Calculator 


Custom 
Locale 


. JO CK Browser 


Car Home Contacts 


- 


Email 


Li 


Music Navigation 


4 


将 用 哪 一 个 AVD 来 测试 您 的 应 用 程序 


第 1 童 ” Android 编程 入 门 


32s hjs]e v |a | o. 
o wj|e |n |r |v u [1 o pa 
^ |s |o lr le fu [s |k ft |&8 
全 zx |c lv le In w |. je 
E C [ s | 


图 1-28 


回忆 一 下 先前 使 用 AVD Manager 创 建 的 几 个 AVD。 那么 , 当 运 行 一 个 Android 应 用 程序 
时 , Eclipse 将 启动 哪 一 个 呢 ? Eclipse 会 检查 您 ( 当 创建 一 个 新 项 目 时 ) 指 定 的 目标 , 将 其 与 已 经 
创建 好 的 AVD 列 表 对 照 , 然后 启动 第 一 个 匹配 的 AVD 来 运行 您 的 应 用 程序 。 

如 果 在 调试 应 用 程序 前 有 多 个 合适 的 AVD 正 在 运行 , Eclipse 将 显示 Android Device 
Chooser 窗 口 , 使 您 可 以 从 中 选择 想 要 的 模拟 器 或 设备 来 调试 应 用 程序 (如 图 1-29 所 示 )。 


Qj Android Device Chooser — 
Select a device compatible with target Android 2.2. 
@ Choose a running Android device 
Serial Number 
emulator-5554 
E emulator-5556 


AVD Name 


(^O Launch a new Android Virtual Device 
Target Name 
No AYD available 


Android 2.2 Emulator 
GoogleAPIs 2,2 Emulator 


State 
Online | 
Online 


Target 
«^ Android 2.2 
«* Google APIs (Google Inc.) 


Debuq 
Yes 


Yes 


Platform APILevel | Details... | 


| Start.. 


ES 


r Manager... 


图 1-29 
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示例 说 明 
为 了 使 用 Eclipse 创 建 一 个 Android 项 目 ， 需 要 提供 如 表 1-2 所 示 的 信息 。 
表 1-2 默认 方式 创建 的 项 目 文件 


属 性 fü o x 

Project name 项 目的 和 名称 

Application name 用 户 友好 的 应 用 程序 名 称 
Package name 包 的 名 称 ， 必 须 使 用 反问 域名 
Create Activity 应 用 程序 中 第 一 个 活动 的 名 称 
Min SDK Version 项 目 所 需 的 最 低 版 本 的 SDK 


在 Android 中 ，Activity( 活 动 ) 是 一 个 包含 您 的 应 用 程序 的 用 户 界 面 的 窗口 。 一 个 应 用 程序 可 
以 有 零 或 多 个 活动 。 本 例 中 ， 应 用 程序 包 售 一 个 活动 : MainActivity。 这 个 MainActivity 是 应 用 
程序 的 入 口 点 ， 在 应 用 程序 局 动 时 显示 。 第 2 章 将 详细 讨论 活动 。 

在 这 个 简单 的 示例 中 ， 修 改 main.xml 文 件 以 显示 字符 串 “This is my first Android 
Application!” 和 一 个 按钮 。main.xml 文 件 包 含 了 这 个 活动 的 用 户 界 面 ， 此 界面 在 MainActivity 加 
载 时 显示 。 

当 在 Android 模 拟 嚣 上 调试 应 用 程序 时 ， 应 用 程序 会 目 动 在 模拟 器 上 进行 安装 一 一 没 错 ， 您 
己 经 开发 了 您 的 第 一 个 Android 应 用 程序 ! 

1.2.6 节 将 揭示 您 的 Android 项 目 中 所 有 这 些 不 同 的 文件 是 如 何 一 起 工作 来 使 程序 正常 运行 的 。 


1.2.6 Android 应 用 程序 剖析 


既然 已 经 创建 了 您 的 第 一 个 Hello World Android 应 用 程序 ， 那 就 该 分 析 一 FAndroid 项 目的 B 


Zi, Bé PEZ TERMAR. 
首先 ， 请 注意 在 Eclipse 的 Package Explorer 中 所 显示 的 构成 


4 RF HelloWorld 
4 [8 


src 
4 Hj net.learn2develop.HelloWorld 


Android 项 日 的 不 回 文件 (如 图 1-30 所 不 ) o i b z pesi nul 
A gen [Generated Java Files 
这 些 不 [i] 的 文件 夹 及 其 文件 如 F : 4 H a 0m 
um m 7 ^. * a * a d Tn 
e SIC 包 c Ti H 的 N avai p-a 件 T 在 本 例 中 有 e X ft : E ri E ondroidjar - CAUsersWWei-Meng Lee Desktop’ 


MainActivity.java. MainActivity.java X fF Zé i5 a If) si xc Eon 
ft. oig eoi ic 


— A- Android SZ FB 程序 南 的 所 Wien o 


€ gen 一 一 包含 了 由 编译 器 生成 的 R.java 文 件 ， 它 引用 在 项 目 
中 能 找到 的 全 部 资源 。 不 要 修改 此 文件 。 PM 
@ ”assets 一 一 这 个 文件 夹 包含 了 应 用 程序 所 用 到 的 所 有 资产 ， ~ 
例如 HTML、 文 本 文件 、 数 据 库 等 。 一 一 一 一 
€ res 一 一 这 个 文件 夹 包含 了 应 用 程序 中 使 用 的 所 有 资源 。 它 图 1-30 
还 包含 了 儿 个 子 文 件 夹 : drawable-<resolution>、layout 和 values。 第 3 章 将 进一步 讨论 如 何 广 
持 具有 不 同 屏 梨 分 辩 紊 和 像素 密度 的 设备 。 


这 是 Android 应 用 程序 的 清单 文件 。 在 这 一 文件 中 ， 可 以 指定 应 


e AndroidManifest.xml 
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HEF BIS BC, wo DARE Hi REPECULER RIMER BH. pm KETE 
AndroidManifest.xml 文 件 的 使 用 。 
main.xml 文 件 定 义 了 活动 的 用 户 界 面 。 注 意 观 察 以 下 代码 的 粗 体 字 部 分 : 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"8string/hello" /> 


这 里 ，@string 指 的 是 位 于 res/values 文 件 夹 下 的 string.xml 文 件 。 因 此 ，@string/hello 指 的 是 
在 strings.xml 文 件 中 定义 的 hello 字 符 串 ， 即 “Hello World, MainActivity!" : 


«?xml version-"1.0" encoding-"utf-8"?- 

«resources» 
«string name-"hello"»5Hello World, MainActivity!«/string» 
«string name-"app name"»HelloWorld«/string» 


«/resources-» 


建议 您 将 应 用 程序 中 所 有 的 字符 串 常 量 存 储 于 这 个 string.xml 文 件 中 ， 并 用 @string 标 识 符 引 
用 这 些 字 符 串 。 这 样 ， 如 果 需 要 将 您 的 应 用 程序 本 地 化 为 另 一 种 语言 ， 则 只 需要 用 目标 语言 替 
换 string.xml 文 件 中 存储 的 字符 串 ， 然 后 册 把 应 用 程序 重新 编 详 一 过 。 

观察 一 下 AndroidManifestxml 文 件 的 内 容 : 


<?xml version-"1.0" encoding-"utf-8"?- 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.HelloWorld" 
android:versionCode-"|" 
android:versionName-"].0"» 
«application android:icon-"8(drawable/icon" android:label-"8string/app name"> 
«activity android:name-".MainActivity" 
android:label-"G8string/app name"» 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"9" /» 
«/manifest» 


文件 AndroidManifest.xml 包 含 了 关于 应 用 程序 的 详细 信息 。 

e 它 定 义 了 应 用 程序 的 包 和 名: netleam2develop.HelloWorld. 

e ”应 用 程序 的 版 本 代码 为 1。 这 个 值 是 用 来 标识 您 的 应 用 程序 的 版 本 号 。 它 可 用 于 以 编程 方式 
确定 应 用 程序 是 否 需要 升级 。 

e 应 用 程序 的 版 本 名 称 是 1.0。 此 字符 串 值 主要 用 来 显示 给 用 户 。 这 个 值 应 该 采用 以 下 格式 : 
«major».«minor».«point» « 

e 应 用 程序 使 用 位 于 drawable 文 件 夹 下 的 图 像 icon.png。 

e ”应 用 程序 的 名 称 是 在 string.xml 文 件 中 定义 的 名 为 app_name 的 字符 串 。 
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€ MainActivity.java 文 件 代 表 了 应 用 程序 中 的 一 项 活动 。 代 表 这 项 活动 的 标签 名 称 与 应 用 程序 
的 名 称 相 同 。 
重 ” 在 这 项 活动 的 定义 中 ， 有 一 个 名 为 <intent-filter> 的 元 素 : 
> 意图 师 选 器 的 动作 名 称 为 android.intent.action.MAIN， 表 明了 这 项 活动 是 应 用 程序 
的 入 口 点 。 
> 意图 贤 选 器 的 类 别名 称 为 android.intent.category.LAUNCHER， 表 明了 应 用 程序 可 从 
设备 的 局 动 占 图 标 局 动 。 第 2 草 将 详细 讨论 意图 。 
€ 最 后 ，<uses-sdk> 元 素 的 android:minSdkVersion 属 性 指定 了 应 用 程序 运行 所 需 的 操作 系统 的 
最 低 版 本 。 
在 向 项 目 中 加 入 更 多 的 文件 和 文件 夹 后 ，Eclipse 将 自动 生成 R.java 的 内 容 ， 而 目前 包含 以 下 
内 容 : 


package net.learn2develop.HelloWorld; 


public final class R | 
public static final class attr I 
] 
public static final class drawable 1 
public static final int icon-0x7/f020000; 
] 
public static final class layout | 
public static final int main-0x7f030000; 
} 
public static final class string | 
public static final int app name-0x/f040001; 
public static final int hello-0x7/f040000; 


} 
建议 您 不 要 修改 R.java 文 件 的 内 容 。 当 您 修改 项 目 时 ，Eclipse 会 目 动 为 您 生成 相应 内 容 。 


: 注意 : 如 果 手 动 删 除了 R.java 文 件 ，Eclipse 会 为 您 立即 再 重新 生成 一 个 。 
注意 ， 为 了 使 Eclipse 可 以 生成 R.java 文 件 ， 您 的 项 目 不 能 巴 仿 任何 错误 。 如 果 
在 删除 R.java 后 发 觉 Eclipse 没 有 重新 生成 这 个 文件 ， 那 么 您 需要 再 检查 一 遍 
您 的 项 目 。 代 码 中 可 能 包含 语法 错误 或 者 XML 文件 (如 AndroidManifest.xml、 
main.xml 等 ) 的 格式 不 良好 。 


最 后 ， 把 活动 连接 到 用 户 界 和 面 (main.xml) 的 代码 是 位 于 MainActivity.java 文 件 中 的 
setContentView() 7] 14: : 
package net.learn2develop.HelloWorld; 


import android.app.Activity; 


import android.os.Bundle; 


public class MainActivity extends Activity I 
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/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView (R.layout.main); 
} 
这 里 ，R.layout.main 指 的 是 位 于 res/layout 文 件 夹 下 的 main.xml 文 件 。 在 同 res/layout 文 件 夹 添 
加 额外 的 XML 文件 时 ，R.java 中 将 目 动 生成 这 个 文件 名 。onCreate() 方 法 是 活动 加 载 时 被 调 用 的 
多 个 方法 之 一 。 第 2 章 将 详细 讨论 活动 的 生命 周期 。 


1.3 本章 小 结 


本 章 介 绍 了 Android 的 概况 ， 并 强调 了 它 的 一 些 功 能 。 如 条 您 已 经 按照 本 章 前 面 所 述 下 载 
了 工具 和 SDKE， 那 么 现在 应 该 有 了 一 个 工作 系统 一 一 一 个 能 够 开发 其 他 比 Hello World 更 有 趣 的 
Android 应 用 程序 的 系统 。 在 第 2 革 ， 您 将 学 习 a 到 有 关 活 动 和 意图 的 概念 以 及 这 些 概 仿 在 Android 
中 所 扮演 的 重要 角色 。 


1. 什么 是 AVD? 


2. AndroidManifest.xml 文 件 中 的 android:versionCode 和 android:versionName 属 性 有 什 
么 区 别 ? 
3. strings.xml 文 件 的 作用 是 什么 ? 


练习 答案 参见 附录 C。 


本 章 主要 内 容 
E A 关键 概念 
Android 操 作 系统 Android 是 一 个 基于 Linux 的 开源 的 手机 操作 系统 。 它 可 以 供 任 何 打 算 使 


之 在 其 自己 设备 上 运行 的 用 户 使 用 
使 用 Java 编 程 语言 开发 Android 应 用 程序 。 编 写 的 应 用 程序 被 编译 成 可 在 
Dalv 还 虚拟 机 之 上 运行 的 Dalv 还 可 执行 文件 
Android Market Android Market 包 括 了 由 第 三 方 开 发 人 员 编 写 的 各 种 Android 应 用 程序 
Android 应 用 程序 开发 工具 Eclipse IDE, Android SDK 和 ADT 

Android 应 用 程序 中 的 一 个 屏 闫 代表 一 个 活动 。 每 一 个 应 用 程序 可 以 有 和 零 


Android YH F RE E 


ini 或 多 个 活动 
AndroidMainifestxml 文 件 包 含 了 应 用 程序 的 详细 配置 信息 。 随 着 应 用 程 
Android 清 单 文件 序 变 得 更 加 复杂 ， 您 需要 不 断 修改 这 个 文件 ， 同 时 在 本 书 的 学 习 过 程 


中 ， 您 将 看 到 可 添加 到 这 个 文件 中 的 不 同 信息 
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活动 和 意图 


本 章 将 介绍 以 下 内 容 
什么 是 活动 
如 何 对 活动 应 用 样式 和 主题 
如 何 将 活动 显示 为 对 话 框 窗口 
理解 意图 的 概念 
如 何 使 用 Intent 对 象 链接 活动 
意图 筛选 器 如 何 使 您 有 选择 地 链接 到 其 他 活动 

e 如何 使 用 通知 回 用 户 显示 警报 

在 第 1 章 中 ， 您 已 经 知道 了 活动 就 是 一 个 包含 应 用 程序 的 用 户 界 面 的 窗口 。 一 个 应 用 程序 可 
以 包含 零 个 或 多 个 活动 。 通 前 ， 应 用 程序 具有 一 个 或 多 个 活动 ， 活 动 的 主要 目的 束 是 与 用 户 区 
互 。 一 个 活动 的 生命 周期 是 指 从 在 屏幕 上 显示 那 一 刻 起 一 直到 最 后 隐藏 所 经 历 的 若干 个 阶段 。 
理解 活动 的 生命 周期 对 确保 应 用 程序 正确 地 工作 是 极其 关键 的 。 本 章 将 学 习 更 多 有 关 活 动 是 如 
何 运行 以 及 在 设计 Android 应 用 程序 时 必须 注意 什么 的 内 容 。 

除了 活动 ，Android 中 的 男 一 个 独特 的 概念 就 是 意图 。 一 个 总 图 从 根本 上 来 说 就 是 能 够 将 来 
目 不 同 应 用 程序 的 不 同 活动 无 颖 连接 在 一 起 工作 的 “胶水 ”， 人 确保 这 些 任务 执行 起 来 像 是 都 属 
于 一 个 单一 的 应 用 程序 。 在 本 章 第 二 部 分 ， 您 将 学 习 a 到 有 关 这 一 重要 概念 的 更 多 内 容 ， 并 学 会 
如 何 使 用 它 来 调用 诸如 Browser、Phone、Maps 等 内 置 应 用 程序 。 


2.1 理解 活动 


首先 让 我 们 看 看 是 如 何 创建 一 个 活动 的 。 要 创建 一 个 活动 ， 需 要 创建 一 个 扩展 Activity 基 类 
的 Java 类 : 


package net.learn2develop.Activities; 
import android.app.Activity; 
import android.os.Bundle; 


public class MainActivity extends Activity 1 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


dOverride 


MN 2X 
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public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 
} 
随后 ， 您 日 己 的 活动 类 将 使 用 在 res/layout 文 件 夹 下 定义 的 XML 文 件 加 载 此 活动 的 用 户 界 和 面 
(UD 组 件 。 本 例 中 ， 将 使 用 main.xml 文 件 来 加 载 用 户 界 和 面 : 


setContentView(R.layout.main); 
应 用 程序 中 的 每 一 个 活动 必须 在 AndroidManifest.xml 文 件 中 声明 ， 如 下 所 示 : 


«?xml version-"1.0" encoding-"utf-8"?-» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Activities" 
android:versionCode-"|" 
android:versionName-"1.0"- 
«application android:icon-"8drawable/icon" 
android:label-"8string/app name"> 
«activity android:name-".MainActivity" 
android:label-"8(string/app name" 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /> 
«category 
android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter^ 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-z"9" /> 


«/manifest-» 


Activity 基 类 定义 了 管理 一 个 活动 的 生命 周期 的 一 系列 事件 。 该 类 定义 了 如 下 事件 : 


€ onCreate() 当 活 动 首 次 被 创建 时 调用 

€ ”onStart(0 一 一 当 活 动 对 用 户 可 见 时 调用 

€ onResume( 当 活 动 与 用 户 开 始 交 互 时 调用 

€ onPause() 在 当前 活动 被 暂停 并 恢复 以 前 的 活动 时 调用 

€ onStop() 一 一 当 活 动 不 再 对 用 户 可 见 时 调用 

€ onDestroy(0 一 一 在 活动 被 系统 销毁 前 调用 (手动 或 由 系统 执行 以 节省 内 存 ) 
全 ”onRestart() 一 一 在 活动 已 停止 并 要 再 次 启动 时 调用 


默认 情况 下 ， 上 所 创建 的 活动 包含 OnCreate() 事 件 。 在 这 个 事件 处 理 程 序 中 含有 帮助 显示 屏 攻 
的 用 户 界 面 元 素 的 代码 。 
图 2-1 展 示 了 一 个 活动 的 生命 周期 及 其 所 经 历 的 各 个 阶段 一 一 从 活动 开始 直到 结束 。 


23 


Android 编 程 入 门 经 典 


onStart() 


onResume() 


onRestart() 


这 个 活动 
io] JB 3 


另 一 个 活动 出 现在 
这 个 活动 之 前 


这 个 活动 不 再 可 见 。 


onStopO 
onDestroyO 


这 个 活动 
回 到 前 合 


本 图 是 依据 Creative Commons 2.5 的 署名 许可 所 描述 的 条 坎 ， 复 制 于 Android 开 源 项 目 创建 
并 共享 的 工作 内 容 ， 详 见 http://developer.android.com/reference/android/app/Activity.html 


图 2-1 


要 了 解 一 个 活动 所 经 历 的 各 个 阶段 ， 最 好 的 办 法 是 创建 一 个 新 项 目 ， 实 现 各 种 事件 ， 然 后 
使 活动 经 受 各 种 用 户 交 互 的 考验 。 


理解 一 个 活动 的 生命 周期 
Activities.zip 代 , 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 启动 Eclipse， 创 建 一 个 新 的 Android 项 目 并 命名 ， 如 图 2-2 所 示 。 
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B New Android Project 
Hew Android Project 


Creates a new Andreid Project respurce, 


Project name — Activities 

Contents 

à: Create new project in workspace 
D Creste project from existing source 
J Use default location 


Location: | i/Users/Wei- Meng Lee Beginning Andraid/Activities 


E Create project from existing sample 


Samples: | Áccel ernmetesP lay 


Build Target 


Target Marne Vendor Platform 
[7] Android 1.5 Android Open Source Project L3 
[] Google APIs Google Inc. 15 
[7] Android 1.5 Android Open Source Project LB 
E| Google APIs Google Inc. 1.5 
E| Android Z1-upda.. Android Open Source Project 2l-upd.. 
[] Google APIs Google Inc. 2,l-upd.. 
[7] Android 2.2 Android Open Source Project 22 
[] Geogle APIs Google Inc. 22 
[] GALAXY Tab Add... Samsung Electronics Co., Ltd. 2.2 
[y] Android 2:3 Andraid Open Source Project 23 
E| Google APIs Google Inc. 23 
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D ADD ED CE) 0A Lo os 后 dd Ud 


Standard Android platform 2.3 
Properties 
Application name: Activities 
ooo e 
y Create Activity: — Main ctivity 
Min SDE Version: D 


(2) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.Activities; 


import android.app.Activity; 
import android.os.Bundle; 


import android.util.Log; 


public class MainActivity extends Activity I{ 


String tag - "Events"; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
@Override 
public void onCreate (Bundle savedInstanceState) 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
Log.d(tag, "In the onCreate() event"); 
} 
public void onStart() 
i 
super.onStart(); 
Log.d(tag, "In the onStart() event"); 
} 
public void onRestart() 
( 
super.onRestart(); 
Log.d(tag, "In the onRestart() event"); 


F 
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} 
public void onResume() 
{ 


super.onResume(); 


Log.d(tag, "In the onResume() event"); 


) 
public void onPause() 
i 
super.onPause(); 
Log.d(tag, 
} 
public void onStop() 
{ 
super.onStop(); 
Log.d(tag, 
} 
public void onDestroy () 
{ 
super.onDestroy(); 
Log.d(tag, 


(3) 按 F11 键 在 Android 模 拟 需 上 调试 应 用 程序 。 


"In the onPause() event"); 


"In the onStop() event"); 


"In the onDestroy() event"); 


(4) 当 活 动 第 一 次 被 加 载 时 ， 应 该 可 以 在 LogCat 窗 口中 看 到 以 下 内 容 ( 单 击 Debug 透视 图 ， 


JL EI2-3): 


12-28 13:45:28.115: DEBUG/Events (334): 
12-28 13:45:28.115: DEBUG/Events (334): 
12-28 13:45:28.115: DEBUG/Events (334): 


Log 
Tinc l tag 

l1z-z28 dalwvilLln 

12-28 45:26. jdwn 

12—28 dalwikwn 

12—28 AndroidEuntimnc 
12-28 Androidhbuntine 
12-28 AndroidkRuntimne 
12-28 ActivityMsnager 
12-28 AndroaidREuntine 
12-28 dalwvikwn 

12—28 

12-28 i: 
[12-28 13:45: 
rro 


dalwikwn 
AndroidRuntine 
Evente 

Events 


12-28 13:45:20.845 
12-28 13:45:29.355 


ai "c 12.40.22 u7c 
司 


ActivityHManager 
dalwilen 
EE PEN 


E 


Filter 


图 2-3 


In the onCreate() event 
In the onStart() event 


In the onHResume() event 


&iuome|j-5-BEH'"-c 


Hessage 

GC CÜONCIEEENT fresd 102E, ?li free 237 
Got wake-up signal. bailing out of sel 
Debugger has detached: object registry 
bł) ÁndraidBuntiazce START con.2ndroi 
ChackJHI is OH 

Calling main entry con.sndroid.connaand 
Starting: Intent { act=android intent. 
Shutting down "VH 

GC COHCUREEHT frezd 102E. 61% free 319 
Debugger has detached; object registry 
HOTE: attach of thread 'Binder Thread 
In thea onlrsatsií) event 

In the nn5rtartí(] event 


Displayed nst.learn2develop.Activities—, 
GC COHCURRERHT fresd 653E, 49% free 40D— 


La 
CO EVOT TOTT £&——4 TOT Dii faan "uüü0"T. 
F 


(5) 如 果 在 Android 模 拟 器 上 按 Back 按 钮 ， 可 以 观察 到 以 下 显示 内 容 : 


12-28 13:59:46.266: DEBUG/Events (334): 
12-28 13:59:46.806: DEBUG/Events (334): 
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In the onPause() event 


In the onStop() event 
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12-28 13:59:46.806: DEBUG/Events(334): In the onDestroy() event 
(6) 按 住 Home 按 钮 不 放 ， 同 时 单 击 Activities 图 标 可 以 看 到 以 下 内 容 : 


12-28 14:00:54.115: DEBUG/Events(334): In the onCreate() event 
12-28 14:00:54.156: DEBUG/Events(334): In the onStart() event 
12-28 14:00:54.156: DEBUG/Events(334): In the onResume() event 


(7) 按 下 Android 模 拟 嚣 上 的 Phone 按 钮 ， 当 前 活动 束 会 被 推 到 后 侣 ， 观 察 LogCat 窗 口中 的 输出 : 


12-28 14:01:16.515: DEBUG/Events(334): In the onPause() event 
12-28 14:01:17.135: DEBUG/Events(334): In the onStop() event 


(8) 注意 ，onDestroyO 事 件 并 没有 被 调 用 ， 表 明 这 个 活动 仍旧 在 内 人 存 中 。 按 Back 按 钮 退出 电 
话 拨号 程序 ， 活 动 叉 册 次 显示 了 。 观 察 LogCat 窗 口中 的 输出 : 


12-28 14:02:17.255: DEBUG/Events(334): In the onRestart() event 
12-28 14:02:17.255: DEBUG/Events(334): In the onStart() event 
12-28 14:02:17.255: DEBUG/Events (334): In the onResume() event 


onRestart0O 事 件 被 激活 ， 随 后 是 onStart0 和 onResume0O 事 件 。 
示例 说 明 


从 这 个 简单 的 示例 可 以 看 出 ， 当 按 下 Back 按 钮 时 ， 一 个 活动 就 被 销毁 了。 知道 这 一 点 是 全 
关 重 要 的 ， 因为 无 论 活 动 当 前 处 于 什么 状态 ， 它 都 将 丢失 。 因 此 ， 震 要 在 您 的 活动 中 额外 写 一 
些 代码 以 便 在 活动 要 销毁 时 可 以 保持 其 状态 (第 3 章 将 告诉 您 怎么 做 )。 在 这 里 ， 注 意 onPause0O 事 
件 在 两 个 情况 下 都 将 被 调用 一 一 当 活 动 被 送 入 后 台 以 及 用 户 按 了 Back 按 钮 而 终止 活动 时 。 
当 一 个 活动 开始 时 ，onStart0 和 onResume0) 事 件 总 是 会 被 调用 ， 而 不 管 这 个 活动 是 从 后 台 恢 
复 的 还 是 新 创建 的 。 


注意 : 即使 一 个 应 用 程序 只 有 一 个 活动 并 且 这 个 活动 被 终止 了 ， 该 应 用 程 


序 仍 旧 会 运行 于 内 存 中 。 


2.1.1 如 何 对 活动 应 用 样式 和 主题 


默认 情况 下 ， 一 个 活动 占据 整个 屏 医 。 人 然而， 也 可 以 对 活动 应 用 一 个 对 话 框 主题 ， 使 其 显示 
为 一 个 浮动 对 话 框 。 例如 i Re 以 弹出 窗口 的 形式 显示 它 ， 用 来 提醒 用 户 将 执 
行 的 一 些 操作 。 在 这 种 情况 下 ， 以 对 话 框 形式 显示 活动 以 引起 用 户 的 注意 是 个 不 错 的 方法 。 

要 对 活动 应 用 对 话 杠 主题， 只 要 修改 AndroidManifest.xml 文 件 中 的 <Activity> 元 率 ， 添 加 
android:theme 必 性: 


<2xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Activities" 
android:versionCode-"]|" 


android:versionName-"1.0"- 


2f 


Androidi ANT 


<application android:icon="@drawable/icon" 
android:label="@string/app name"> 
«activity android:name-".MainActivity" 
android:label-"G8string/app name" 
android:theme-"(tandroid:style/Theme.Dialog" > 
«intent-filter-^ 
«action android:name-"android.intent.action.MAIN" /> 
«category 
android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"9" /» 


«/manifest» 


Xx Fog n] ELSE SI Sz N AJ — PS wd, "Wl2-APT. 


&  355bAndracid 2.3 Emulator 


| see all your apps. 
| Touch the Launcher icon. 


ES Activities 


ES Hello world, MalnActtvIty l9 


图 2-4 


2.1.2 ”隐藏 活动 标题 


如 琳 需 要 的 话 ， 还 可 以 隐藏 一 个 活动 的 标题 (例如 当 您 打算 辣 用 户 显 示 状 态 更 新 时 )。 要 做 a 到 
这 一 点 ， 可 以 使 用 requestWindowFeature() 方 法 ， 传 递 Window.FEATURE_NO_TITLE 常 量 ， 如 下 
所 不 : 


package net.learn2develop.Activities; 
import android.app.Activity; 
import android.os.Bundle; 


import android.util.Log; 


import android.view.Window; 
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public class MainActivity extends Activity I{ 


String tag = "Events"; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
aOverride 
public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


//--- 隐 藏 标题 栏 --- 


requestWindowFeature (Window.FEATURE NO TITLE); 


setContentView(R.layout.main); 


Log.d(tag, "In the onCreate() event"); 


这 样 ， 标 题 住 就 被 隐藏 了 ， 如 图 2-5 所 示 。 


» 
&  555&Android 2.3 Emulator 


TE SE Nr E EEIT EEEE 


- Hello world, MalnActivitylt 


图 2-5 


2.1.3 ”显示 对 话 框 窗口 


您 经 常会 需要 显示 一 个 对 话 框 窗口 ， 以 便 从 用 户 那 里 得 到 确认 。 这 上 时， 可 以 重 写 在 Activity 
基 类 中 定义 的 受 保 护 的 onCreateDialog() 方 法 来 显示 一 个 对 话 框 。 下 面 的 “ 试 一 试 ” 会 告诉 您 怎 
么 做 。 


使 用 活动 显示 一 个 对 话 框 


Dialog.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse 创建 一 个 新 的 Android 项 目 ， 并 将 其 命名 为 Dialog。 
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(2) 将 下 列 粗 体 显 示 的 语句 瀛 加 到 main.xml 文 件 中 : 


«?xml version-"1.0" encoding-"utfí-8"?- 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:orientation-^"vertical" 


android:layout width-"fill parent" 


android:layout height-"fill parent" > 


«TextView 


android:layout width-"fill parent" 


android:layout height-"wrap content" 
android:text-"(string/hello" /> 


«Button 


android:id-"(-id/btn dialog" 
android:layout width-"fill parent" 


android:layout height-"wrap content" 
android:text-"Click to display a dialog" /> 
«/LinearLayout» 


(3) 将 下 列 粗 体 显 示 的 语句 添加 到 MainActivity.java 文 件 中 : 


package net.learn2develop.Dialog; 


import 
import 
import 
import 
import 
import 
import 
import 


android 


android. 


android. 


android 


android. 
android. 
android. 


android. 


.app.Activity; 

os.Bundle; 
app.AlertDialog; 
.app.Dialog; 
content.DialogInterface; 
view.View; 
widget.Button; 
widget.Toast; 


public class MainActivity extends Activity I 


CharSequence[] items = ( "Google", "Apple", "Microsoft" ); 


boolean[] itemsChecked - new boolean [items.length]; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 


public void onCreate (Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


Button 


btn = (Button) findViewById(R.id.btn dialog); 


btn.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 


}); 


showDialog (0); 
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lOverride 
protected Dialog onCreateDialog(int id) { 
switch (id) { 
case O0: 
return new AlertDialog.Builder(this) 
.setIcon(R.drawable.icon) 
.setTitle("This is a dialog with some simple text...") 
.setPositiveButton("OK", new 
DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int whichButton) 
{ 
Toast.makeText(getBaseContext(), 
"OK clicked!", Toast.LENGTH SHORT).show(); 


)) 
.setNegativeButton("Cancel", new 
DialogInterface.OnClickListener() 1 
public void onClick(DialogInterface dialog, 
int whichButton) 


Toast.makeText(getBaseContext(), 
"Cancel clicked!", Toast.LENGTH SHORT).show(); 


)) 
.setMultiChoiceltems (items, itemsChecked, new 
DialogInterface.OnMultiChoiceClickListener() { 
GOverride 
public void onClick (DialoglInterface dialog, int which, 
boolean isChecked) { 
Toast.makeText(getBaseContext(), 
items[which] + (isChecked ? " checked!": 
" unchecked!"), 
Toast.LENGTH SHORT).show(); 


) 
.create(); 


} 


return null; 


(4) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 单 击 按钮 显示 对 话 框 (如 图 2-6 所 示 )。 选 中 
不 同 的 复 选 框 会 使 Toast 类 显示 那些 选中 /未 选中 项 的 文本 。 要 关闭 对 话 框 ， 可 单 击 OK 或 Cancel 
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0000 
This is a dialog with Ty 
p some simple text... eo e | m 


Google | e 一 e (e 


Apple 


Microsoft 回国 国 国 国 国 国 国 国 加 加 | 

alw le le lr ly lu lr lo lp 
A lsslo le le lu lu le lu [8 
alz Ix le lv le Iu m]. le 
mm p em em ee 


图 2-6 


示例 说 明 
要 显示 一 个 对 话 框 ， 首 先 需要 重 写 Activity 类 中 的 onCreateDialog(0 方 法 : 


GOveTrTride 
protected Dialog onCreateDialog(int id) { 


FE 
) 


在 调用 showDialog() 方 法 时 调用 这 个 方法 : 


Button btn = (Button) findViewById(R.id.btn dialog); 
btn.setoOnClickListener(new View.OnClickListener() { 
public void onClick(View v) 1 
showDialog (0); 


}); 


onCreateDialogO 是 一 个 用 于 创建 由 活动 管理 的 对 话 框 的 回调 方法 。 当 调用 showDialog() 
方法 时 ， 将 亩 用 这 个 方法 。showDialog( 方 法 接受 一 个 整 型 参数 ， 用 来 标识 要 显示 的 特定 对 
要 创建 一 个 对 话 框 ， 需 要 使 用 AlertDialog 类 的 Builder 构 造 函 数 来 设置 不 同 的 属性 ， 例 如 
QOverride 
protected Dialog onCreateDialog(int id) l| 


switch (id) f 


case 0: 
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return new AlertDialog.Builder (this) 
.SetIcon(R.drawable.icon) 
.setTitle("This is a dialog with some simple text...") 
.SetPositiveButton("OK", new 
DialogInterface.OnClickListener() I 
public void onClick(DialogInterface dialog, 
int whichButton) 
{ 
Toast.makeText(getBaseContext () ， 
"OK clicked!", Toast.LENGTH SHORT).show(); 


}) 
.SetNegativeButton("Cancel", new 
DialogInterface.OnClickListener() 1| 
public void onClick(DialogInterface dialog, 
int whichButton) 


Toast.makeText(getBaseContext (), 
"Cancel clicked!", Toast.LENGTH SHORT).show(); 


F) 
.SetMultiChoiceltems(items, itemsChecked, new 
DialogInterface.OnMultiChoiceClickListener() { 
QOverride 
public void onClick(DialogInterface dialog, int which, 
boolean isChecked) | 
Toast.makeText (getBaseContext () , 
items[which] + (isChecked ? " checked!": 
" unchecked!"), 
Toast.LENGTH SHORT).show(); 


] 
} 
) 
.Create(); 
} 
return null; 
] 
以 上 代码 使 用 setPositiveButton() 和 setNegativeButton() 方 法 分 别 BR This is a dialog with 
设置 了 两 个 按钮 : OK 和 Cancel。 还 可 以 通过 setMultiChoiceItems() WEE somesmpe text.. 


方法 设置 一 个 复 选 框 列表 供用 户 选 择 。 对 十 setMultiChoiceItems() 方 Google 
法 ， 需 要 传 入 两 个 数组 : 一 个 是 要 显示 的 项 列表 ， 另 一 个 包含 了 表 
明 每 个 项 是 否 被 选中 的 值 。 当 选中 一 个 项 时 ， 使 用 Toast 类 来 显示 一 [| ^PP'e 
条 信息 (如 图 2-7 所 示 )。 


Microsoft 
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上 下 文 对 象 


在 Android 中 常常 会 遇 到 Context 类 和 其 实例 。 Context 类 的 实例 常用 来 给 应 用 程序 提供 引 
用 ,例如 , 在 本 示例 中 , Toast 类 的 第 一 个 参数 接受 一 个 Context 对 创 。 
return new AlertDialog.Builder(this) 
.SetIcon(R.drawable.icon) 
-56€tTitle ("This is a dialog with some simple text...") 
.SetPositiveButton("OK", new 
DialogInterface.0nClickListener() | 
public void onClick(DialogInterface dialog, 
int whichButton) 
{ 
Toast.makeText(getBaseContext(), 


"OK clicked!", Toast.LENGTH SHORT).show(); 


}) 


但 是 , 由 于 Toast() 类 并 没有 在 活动 中 直接 使 用 (而 是 在 AlertDialog 类 中 使 用 ), 因此 需要 使 
用 getBaseContext() 方 法 返回 一 个 Context 类 的 实例 。 

另 一 个 会 遇 到 Context 类 的 地 方 是 当 在 一 个 活动 中 动态 创建 视图 时 。 例如 , 您 可 能 想 通 过 
代码 动态 创建 一 个 TextView 视 图 。 因此 , 使 用 如 下 语句 实例 化 TextView 类 : 


TextView tv = new TextView(this); 


TextViewJE 84] 435 c 4-3 — ^ - Context*] $-, 因为 Activity 类 是 Context 类 的 子 类 , 因此 
可 以 使 用 this 关 键 字 来 代表 这 个 Context 对 和 象 。 


2.1.4 显示 进度 对 话 框 

除了 前 一 节 介绍 的 普通 对 话 框 外 ， 还 可 以 创建 进度 对 话 框 。 进 度 对 话 框 对 于 显示 一 些 活动 
的 进度 很 有 用 ， 如 下 载 操作 的 状态 。 

下 面 的 “ 试 一 试 ” 将 告诉 您 如 何 显示 一 个 进度 对 话 框 。 


使 用 活动 显示 一 个 进度 对 话 框 窗口 


(1) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
package net.learn2develop.Dialog; 


import android.app.Activity; 

import android.app.AlertDialog; 

import android.app.Dialog; 

import android.content.DialogInterface; 
import android.os.Bundle; 

import android.view.View; 


import android.widget.Button; 
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import android.widget.Toast; 


import android.app.ProgressDialog; 
import android.os.Handler; 
import android.os.Message; 


public class MainActivity extends Activity I 
CharSequence[] items = { "Google", "Apple", "Microsoft" }; 


boolean[] itemsChecked = new boolean [items.length]|; 


private ProgressDialog  progressDialog; 
private int progress = 0; 


private Handler  progressHandler; 


/** 当 活动 第 一 次 被 创建 时 调用 。 */ 

aOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedlInstanceState); 


setContentView(R.layout.main); 


Button btn = (Button) findViewById(R.id.btn dialog); 
btn.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) I 
showDialog (1); 
| progress = 0; 
| progressDialog.setProgress (0); 


| progressHandler.sendEmptyMessage (0); 


)):; 


| progressHandler = new Handler() { 
public void handleMessage (Message msg) I 

super.handleMessage (msg); 

if ( progress >= 100) ( 
| progressDialog.dismiss(); 

) else I 
|progresstt; 
| progressDialog.incrementProgressBy (1); 
|progressHandler.sendEmptyMessageDelayed(0, 100); 


QGOverride 
protected Dialog onCreateDialog(int id) | 
switch (id) 1 
case 0: 
return new AlertDialog.Builder(this) 
Fires 
ETF 


.create(); 
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case 1: 
| progressDialog = new ProgressDialog(this); 
| progressDialog.setlicon(R.drawable.icon); 
| progressDialog.setTitle("Downloading files..."); 
|progressDialog.setProgressStyle (ProgressDialog.STYLE HORIZONTAL) ; 
|progressDialog.setButton(DialogInterface.BUTTON POSITIVE, "Hide", new 
DialogInterface.OnClickListener() I 
public void onClick(DialogInterface dialog, 
int whichButton) 


Toast.makeText(getBaseContext(), 
"Hide clicked!", Toast.LENGTH SHORT).show(); 


); 
| progressDialog.setButton(DialogInterface.BUTTON NEGATIVE, "Cancel", new 
DialogInterface.OnClickListener() ( 
public void onClick(DialogInterface dialog, 
int whichButton) 


Toast.makeText(getBaseContext(), 
"Cancel clicked!", Toast.LENGTH SHORT).show(); 


I3; 


return  JprogressDialog; 


} 


return null; 


) 
(2) T&F1198&fEAndroidEidU 28 EE V HER BEIT VIVA. PP HLT EISE Wi fte Cu F12-8H7 
示 )。 注 意 观 察 进 度 条 将 累计 到 100。 


8^ 555& Android 2.3 Emulator 


基 BN 
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示例 说 明 


为 了 创建 一 个 进度 对 话 框 ， 首 先 要 创建 一 个 ProgressDialog 类 的 实例 并 设置 其 不 同 的 属性 ， 


| progressDialog = new ProgressDialog (this); 

 progressDialog.setlIcon(R.drawable.icon); 

 progressDialog.setTitle("Downloading files..."); 

 progressDialog.setProgressStyle(ProgressDialog.STYLE 
HORIZONTAL); 


然后 设置 在 进度 对 话 框 中 显示 的 两 个 按钮 


 progressDialog.setButton(DialogInterface.BUTTON POSITIVE, "Hide", new 
DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int whichButton) 


i 
Toast.makeText(getBaseContext (), 
"Hide clicked!", Toast.LENGTH SHORT).show(); 
} 
H)? 


_progressDialog. setButton (DialoglInterface.BUTTON NEGATIVE, "Cancel", new 
DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int whichButton) 


Toast.makeText(getBaseContext (), 
"Cancel clicked!", Toast.LENGTH SHORT).show(); 


H; 


return progressDialog; 


E wi E 318 


Hello World, MainActivity! 


} Click to display a dialog 


结果 束 出 现 了 一 个 进度 对 话 框 (如 图 2-9 所 示 )。 
为 了 在 进度 对 话 框 中 显示 进展 情况 ， 需 要 使 用 一 个 Handler 对 象 | 
运行 一 个 后 合 线程 : o% 0/100 


progress = 0; 


| P Downloading files... | 


| progressDialog.setProgress (0); 


| progressHandler.sendEmptyMessage (0) 
RREA, 8E AGE AGER 10078 b: 


 progressHandler = new Handler() I 图 2-9 


public void handleMessage (Message msg) { 
super.handleMessage (msg); 
if ( progress >= 100) 1 
 progressDialog.dismiss(); 
} else { 


progressi; 


3f 
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 progressDialog.incrementProgressBy(1); 


| progressHandler.sendEmptyMessageDelayed(0, 100); 


}s 


当 计 数 达 到 100 时 ， 进 度 对 话 框 将 消失 。 


2.2 ”使 用 意图 链接 活动 


一 个 Android 应 用 程序 可 以 包含 零 或 多 个 活动 。 当 应 用 程序 具有 多 个 活动 时 ， 您 可 能 需要 从 
一 个 活动 导航 到 另 一 个 活动 。 在 Android 中 ， 活 动 之 间 的 导航 通过 意图 来 完成 。 

要 理解 Android 中 这 个 非常 重要 又 有 些 抽象 的 概念 ， 最 好 的 办 法 就 是 亲自 去 体验 一 下 ， 看 看 
到 底 是 什么 帮 您 实现 了 目标 。 

下 面 的 “ 试 一 试 ” 将 告诉 您 如 何在 一 个 已 有 的 项 目 中 添加 另 一 个 活动 ， 并 在 这 两 个 活动 之 
间 实 现 导 航 。 


i—x 使 用 意图 链接 活动 


(1) 使 用 先前 创建 的 Activities 项 目 ， 在 AndroidManifest.xml 文 件 中 添加 下 列 粗 体 显示 的 
语句 ; 


<?xml version-"1.0" encoding-"utf-8"?- 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Activities" 
android:versionCode-"]" 
android:versionName-"1.0"» 
«application android:icon-"8drawable/icon" android:label-"8string/app name"> 
«activity android:name-".MainActivity" 


android:label-"Q8string/app name" 


«intent-filter- 


«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
«/activity» 
«activity android:name-".Activity2" 
android:label-"Activity 2"> 
«intent-filter^ 
«action android:name-"net.learn2develop.ACTIVITY2" /> 
Xcategory android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 
«/activity» 
«/application» 


«uses-sdk android:minSdkVersion-"9" /» 
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注意 : 您 需要 移 除 划 删 除 线 的 属性 。 


依次 选择 New | Class( 如 图 2-10 所 示 )。 


(2) 右 击 src 文 件 夹 下 的 包 名 ， 


回 Activities Manifest 器 ^ 


| 4 (eS Activities «?xml versionz"1.0" encodinge"utf-B8"?» 


4 E src 
|| EE 


| op.Activiti 
b [J] MainActivityjava | 
b &B gen [Generated Java Files] 
» mà Android 2.3 

Cs. assets 


Go Into 


Open in New Window 
Open Type Hierarchy 


Show In 


4 起: res 
p © drawable-hdpi 
b & drawable-Idpi 
b (E drawable-mdpi 
4 EE layout 
IX) main.xml 


Copy 
Copy Qualified Name 
Paste 


2-10 


^c emanifest 


DRCER 


xmlns: 


Interface 
Enum 
Annotation 


(3) 将 新 的 类 文件 命名 为 Activity2( 如 图 2-11 所 示 )， 单 击 Finish 按 钮 。 


(4) 右 击 main.xml 文 件 并 选择 Copy 命 令 创建 一 个 副本 。 然 后 右 击 res/layout 文 件 夹 并 选择 Paste。 将 


副本 文件 命名 为 activity2.xml。 现 在 ，reslayout 文 件 夹 下 就 包含 了 activity2.xn1l 文 件 (如 图 2-12 所 示 )。 


Java Class 


Create a new Java class. 


Source folder: 
Package: 
| endosing ype: | 


Activities/src 


net.learn2develop.Activities 


| Name: 
Modifiers: 


Activity2 
© public © default 
| jabstract | |final 


java.lang.Object 


private protected 


[ |static 
Superclass: 
Interfaces: 


Which method stubs would you like to create? 
publie static void main(String[] args) 
Constructors from superclass 
Inherited abstract methods 
Do you want to add comments? (Configure templates and default value here) 
Generate comments 


4 (c3 Activities 
4 (8 src 
4 1H netlearn2develop.Activities 
b 四 Activity2.java 
» 四 MainActivity.java 
cm gen [Generated Java Files] 
b BÀ Android 2.3 
g> res 
b (E drawable-hdpi 
b 芝 drawable-ldpi 
» (E drawable-mdpi 


IX) main.xml 
b [£» values 
kci) AndroidManifest.xml 
[5] default.properties 
proquard.cfg 


(5) 按 如 下 所 示人 修改 activity2.xml 文 件 : 


«?xml version-"1.0" encoding-"utf-8"?-» 


图 2-12 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
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android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 

<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"This is Activity 2!" 
/> 


</LinearLayout> 


(6) 将 下 列 粗 体 显示 的 语句 添加 到 Activity2.java 文 件 中 : 


package net.learn2develop.Activities; 


import android.app.Activity; 
import android.os.Bundle; 


public class Activity2 extends Activity ( 
QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.activity2); 


(7) 按 下 列 粗 体 字 内 容 修改 MainActivity.java 文 件 : 


package net.learn2develop.Activities; 


import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 


import android.view.Window; 


import android.view.KeyEvent; 


import android.content.Intent; 


public class MainActivity extends Activity I 
String tag = "Events"; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


/ /一 -- 隐 着 标题 栏 --- 
//requestWindowFeature (Window.FEATURE NO TITLE); 
setContentView(R.layout.main); 


Log.d(tag, "In the onCreate() event"); 
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public boolean onKeyDown(int keyCode, KeyEvent event) 


{ 
if (keyCode == KeyEvent.KEYCODE DPAD CENTER) 
{ 
startActivity (new Intent("net.learn2develop.ACTIVITY2")); 
} 
return false; 
} 
public void onStart() I ay.ie 1 
public void onRestart () f ffaca} 
public void onResume() [ Jf. l 
public void onPause() I Fr... I 
public void onStop() { //-.-.. 1 
public void onDestroy() | ffaca l 


} 


(8) 按 Fl11 键 在 Android 横 拟 器 上 调试 应 用 程序 。 当 第 一 个 活动 被 加 载 时 ， 单 击 方 回 键盘 的 中 
间 ( 如 图 2-13 所 示 ; 在 一 个 真实 设备 上 ， 这 个 操作 可 以 通过 按 下 轨迹 球 来 完成 )。 这 时 ， 第 二 个 活 
动 将 被 加 载 。 


”333Android 之 3 Emulator 


2-13 


示例 说 明 


正如 已 经 学 习 过 的 ， 一 个 活动 是 由 一 个 用 户 界 面 组 件 ( 例 如 ，main.xml) 和 一 个 类 组 件 ( 例 
如 ，MainActivity.java) 组 成 。 因 此 ， 如 果 想 回 项 目 中 添加 另外 的 活动 ， 需 要 创建 这 两 个 组 件 。 
在 AndroidManifest.xml 文 件 中 ， 专 门 添 加 了 以 下 内 容 : 


«activity android:name-".Activity2" 
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android:label-"Activity 2"> 
«intent-filter- 
«action android:name-"net.learn2develop.ACTIVITY2" /» 
«category android:name-"android.intent.category.DEFAULT" /» 
«/intent-filter» 
«/activity» 
到 这 里 ， 您 已 经 给 应 用 程序 添加 了 一 个 新 的 活动 。 注 意 以 下 事项 : 
e 沭 加 的 新 活动 的 名 称 是 Activity2。 
e ”活动 显示 的 标签 名 称 为 Activity2 。 
e Mis iim 意 ds Ra pee .ACTIVITY2。 — pei 


ePi patti. 内 有 相同 WE 
e 意图 简 选 器 的 类 别 是 android.intent.category.DEFAULT。 您 需要 将 类 别 添加 给 意图 算 选 器 ， 
使 其 他 活动 可 以 通过 使 用 startActivity0) 方 法 局 动 这 个 活动 ( 稍 候 将 作 进 一 步 介 绍 )。 
MainActivity.java 文 件 中 实现 了 onKeyDown 事 件 处 理 程序 。 无 论 何 时 用 户 按 下 设备 上 的 一 
个 按键 ， 这 个 事件 都 会 被 触发 。 当 用 户 按 下 方 同 键盘 的 中 间 按 键 时 (由 KeyEvent.KEYCODE_ 
DPAD_CENTER 常 量 来 表示 )， 您 要 使 用 startActivity0 方 法 来 显示 Activity2， 可 以 通过 创建 一 个 
Intent 类 的 实例 并 将 Activity2 的 意 几 师 选 露 名 称 ( 即 netlearn2develop.ACTIVITY2) 传 递 给 这 个 实例 


public boolean onKeyDown(int keyCode, KeyEvent event) 


{ 
if (keyCode == KeyEvent.KEYCODE DPAD CENTER) 
{ 
startActivity (new Intent("net.learn2develop.ACTIVITY2")); 
} 
return false; 
} 


Android 中 的 活动 可 以 被 设备 上 运行 的 任意 应 用 程序 调用 。 例 如 ， 可 以 创建 一 个 新 的 Android 
项 目 ， 然 后 使 用 Activity2 的 意图 沛 选 器 net.learn2develop. MT 最 示 Activity2。 使 一 个 应 
用 程序 容易 地 调用 其 他 应 用 程序 是 Android 中 的 基本 概念 之 

如 条 要 调用 的 活动 是 定义 在 同一 个 项 目 之 中 的 ， 可 以 像 下 面 这 样 重 写 先 前 的 语句 : 


startActivity(new Intent(this, Activity2.class)); 


不 过 ， 只 有 当 您 要 显示 的 活动 是 在 同一 个 项 目 中 作为 当前 活动 时 ， 这 种 方法 才 是 适用 的 。 


2.2.1 f EXE m HRS 


在 先 玉 章节 中 ， 我 们 已 经 学 习 了 用 <intent-filter> 元 素来 定义 如 何 使 一 个 活动 被 另 一 个 活动 所 
调用 。 其 他 活动 (在 相同 或 一 个 单独 的 应 用 程序 中 ) 如 果 具 有 相同 的 筛选 器 名 称 会 呢 ? 例 
如 ， 假 设 应 用 程序 有 另外 一 个 名 为 Activity3 的 活动 ， 在 AndroidManifestxml 文 件 中 具有 以 下 入 口 : 


<?xml version-"1.0" encoding-"utf-95"?- 
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«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"net.learn2develop.Activities" 


android:versionCode-"]" 


android:versionName-"1.0"- 


«application android:icon-"8drawable/icon" android:label-"8string/app name"- 


«activity android:name-".MainActivity" 


android:label-"G8string/app name" > 


<! —-— android:theme-"Q8android:style/Theme.Dialog" --> 


«intent-filter-» 


«action android:name-"android.intent.action.MAIN" /> 


«category android:name-"android.intent.category.LAUNCHER" /» 


«/intent-filter» 
«/activity» 


«activity android:name-".Activity2" 


android:label-"Activity 2"» 


zintent-filter-» 


«action android:name-"net.learn2develop.ACTIVITY2" /» 


«category android:name-"android.intent.category.DEFAULT" /> 


«/intent-filter-» 
«/activity» 


«activity android:name-".Activity3" 
android:label-"Activity 3"» 


«intent-füilter» 


«action android:name-"net.learn2develop.ACTIVITY2" /> 
«category android:name-'"android.intent.category.DEFAULT" /> 


«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"9" /> 
«/manifest» 


如 果 调 用 和 带 有 下 列 意图 的 startActivity() 方 法 ， 
Android 操 作 系 统 会 显示 一 个 选择 ， 如 图 2-14 所 示 : 


startActivity (new Intent("net. 
learn2develop.ACTIVITY2")); 


如 果 您 选中 了 Use by default for this action 项 来 选择 一 
个 活动 ， 那 么 下 一 回 将 再 一 次 调用 意图 net.learn2develop. 
ACTIVITY2， 它 将 总 是 局 动 先前 您 选择 过 的 活动 。 

为 了 清除 这 个 默认 值 ， 转 到 Android 中 的 Settings 应 用 
程序 ， 依 次 选择 Applications | Manage applications, 3X 
择 应 用 程序 名 称 (如 图 2-15 所 示 )。 当 应 用 程序 的 详细 信 
明显 示 出 来 时 ， 将 屏幕 深 动 到 底部 并 单 击 Clear defaults 
按钮 。 


8^ 555&Android 2.3 Emulator 


z wi 2:43 


Ac [ Iv | t lēs 


Complete action using 


2 Activity 2 
a Activity 3 


I Use by default for this action. 


Clear default in Home Settings > 
Applications > Manage applications. 


图 2-14 
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8' 555& Android 2.3 Emulator Ir 5556:Android 2.3 Emulator 


a wi 因 2:45 z wl È 2:45 


EE | | Force stop Uninstall 
AJ On 5D card Running 


Activities Storage 


— 400KB | .24.00KB 


Application 24.00KB 
CantentProviders pp NEM. E Rr 
2  40.00KB | Data .0.00B 


i Dialog 
E 24.00KB Cache 


Files Cache an a 
ES 28.00KB 


Provider | Launch by default 
à ie You have selected to launch this application by 
default for some actions. 


Internal storage Clear defaults 


25MB used 39MB free 


2.2.2 意图 返回 结果 


startActivity() 方 法 调用 另 一 个 活动 ， 但 并 没有 返回 结果 给 当前 活动 。 例 如 ， 您 可 能 有 一 个 用 
于 向 用 户 提示 用 户 名 和 密码 的 活动 。 用 户 在 这 个 活动 中 输入 的 信息 需要 回 传 给 调用 它 的 活动 来 
作 进一步 的 处 理 。 如 果 需 要 从 一 个 活动 中 回 传 数据 ， 应 该 使 用 startActivityForResult0 方 法 。 下 面 
的 “ 试 一 试 ” 演 示 了 这 一 过 程 。 


从 一 个 活动 获得 结果 


(1) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 main.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


«?xml version-"1.0" encoding-"utfí-8"?- 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 


android:layout width-"fill parent" 


android:layout height-"fill parent" > 
«TextView 

android:layout width-"fill parent" 

android:layout height-"wrap content" 

android:text-"Please enter your name" /» 
«EditText 

android:id-"(tid/txt username" 

android:layout width-"fill parent" 

android:layout height-"wrap content" /? 
«Button 

android:id-"(-id/btn OK" 

android:layout width-"fill parent" 


LI 
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android:layout height-"wrap content" 
android:text-"OK" /» 
«/LinearLayout» 


(2) 将 下 列 粗 体 显 示 的 语句 添加 到 Activity2.java 文 件 中 : 


package net.learn2develop.Activities; 


import 


import 


import 
import 
import 
import 
import 


android. 


android. 


android. 


android 
android 
android 


app.Activity; 


os.Bundle; 


content.Intent; 


.net.Uri; 
.View.View; 
.Widget.Button; 
android. 


widget.EditText; 


public class Activity2 extends Activity 1 


GOverride 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView(R.layout.activity2); 


//--- 获 得 OK 按钮 --- 
Button btn = (Button) findViewById(R.id.btn OK); 


//---OK 按 钮 的 事件 处 理 程 序 --- 
btn.setOnClickListener(new View.OnClickListener() 


{ 


public void onClick(View view) { 


)); 


Intent data - new Intent(); 


//--- 获 得 EditText 视 图 --- 
EditText txt username = 
(EditText) findViewById(R.id.txt username); 


//--- 设 置 回 传 的 数据 --- 
data.setData (Uri.parse( 

txt username.getText().toString())); 
setResult(RESULT OK, data); 


//--- 关 闭 活动 --- 
finish(); 


(3) 将 下 列 粗 体 显 示 的 语句 添加 a 到 MainActivity.java 文 件 中 : 


package net.learn2develop.Activities; 


活动 和 意图 
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import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 
import android.view.Window; 
import android.view.KeyEvent; 
import android.widget.Toast; 


import android.content.Intent; 


public class MainActivity extends Activity 1 
String tag = "Events"; 


int request Code = 1; 


/** 当 活 动 第 一 次 被 创建 时 调用 。*/ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


//--- 隐 藏 标题 栏 --- 


//requestWindowFeature (Window.FEATURE NO TITLE); 


setContentView(R.layout.main); 


Log.d(tag, "In the onCreate() event"); 


public boolean onKeyDown(int keyCode, KeyEvent event) 
i 
if (keyCode == KeyEvent.KEYCODE DPAD CENTER) 
{ 
//startActivity (new Intent("net.learn2develop.ACTIVITY2")); 
//startActivity (new Intent(this, Activity2.class)); 


startActivityForResult(new Intent( 
"net.learn2develop.ACTIVITY2"), 
request Code); 
} 


return false; 


public void onActivityResult(int requestCode, int resultCode, Intent data) 
i 
if (requestCode == request Code) | 
if (resultCode == RESULT OK) ( 
Toast.makeText(this,data.getData().toString(), 
Toast.LENGTH SHORT).show(); 


} 
} 
} 
public void onStart() Tg. d 
public void onRestart() { Ffloe ÀJ 
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public void onResume() { fos ] 
public void onPause() Lh da | 
public void onStop () { //-.-.. T 
public void onDestroy() I Xa. ] 


8' 555&Android 2.3 Emulator E 5555; Android 2.3 Emulator 


(4) 按 F11 键 在 Android 横 拟 器 
上 调试 应 用 程序 。 当 加 载 第 一 个 中 wi 149 | 


ACEIVICy Z 


活动 时 , T 击 万 fa] 键盘 上 中 [H] m Please enter your name Hello World, MainActivityl 


Wei-Meng Lee 


按钮 ，Activity2 将 被 加 载 。 输 入 
您 的 姓名 (如 图 2-16 所 示 ) 并 单 击 
OK 按钮 。 这 时 ， 第 一 个 活动 会 显 

示例 说 明 

调 用 m T 酒 动 并 等 行 从 | Wel-Meng Lee | 
此 活动 返回 结果 ， 需 要 使 用 
startActivityForResult() 方 法 ， 如 
下 所 示 : 


图 2-16 


startActivityForResult (new Intent( 
"net.learn2develop.ACTIVITY2"), 
request Code); 


除了 传 入 一 个 Intent 对 象 ， 还 需要 传 入 请 求 码 。 请 求 码 仅仅 是 一 个 整数 值 ， 用 来 标识 正在 调 
用 的 活动 。 这 是 必需 的 ， 因 为 当 一 个 活动 返回 一 个 值 时 ， 必 须 有 办 法 将 它 标识 出 来 。 例 如 ， 您 
可 能 同时 在 调用 多 个 活动 ， 而 一 些 活动 可 能 没有 立即 返回 (如 正在 等 待 服务 器 的 应 答 )。 当 一 个 活 
动 返回 时 ， 需 要 这 个 请 求 码 来 确定 实际 返回 的 是 哪 一 个 活动 。 


注意 : 如 果 请 求 码 设 为 -1， 则 使 用 startActivityForResult0 方 法 来 调用 活动 与 


站 使 用 startActivity0 方 法 来 调用 是 等 同 的 。 也 就 是 说 ， 没 有 结果 返回 。 


为 了 使 被 调 活 动 可 以 返回 一 个 值 给 调用 它 的 活动 ， 可 以 通过 setData() 方 法 使 用 一 个 Intent 对 
象 来 回 传 数 据 : 


Intent data = new Intent(); 


//--- 获 得 EdqitText 视 图 --- 
EditText txt username = 
(EditText) findViewById(R.id.txt username); 


/ / - —ÓÀ5 8 BENA- 
data.setData (Uri.parse( 


txt username.getTextí().toString())); 


Af 
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setResult(RESULT OK, data); 


// — 3 Wiiásli-—- 
ftinishí(); 
setResult0) 方 法 设置 了 一 个 结果 码 (RESULT_OK 或 是 RESULT_CANCELLED) 和 回 传 给 调用 
活动 的 数据 (一 个 Intent 对 象 )。finish0O 方 法 关闭 活动 并 将 控制 返回 给 调用 者 。 
在 调用 者 活动 中 ， 需 要 实现 onActivityResult0 方 法 ， 一 个 活动 无 论 何 时 返回 都 要 调用 这 个 方法 : 


public void onActivityResult(int requestCode, int resultCode, Intent data) 


i 
if (requestCode == request Code) | 
if (resultCode == RESULT OK) | 
Toast.makeText(this,data.getData().toString(), 
Toast.LENGTH SHORT).show(); 
} 
} 
} 


这 里 ， 检 验 请 求 码 的 正确 性 ， 并 显示 返回 的 结果 。 返 回 的 结果 通过 data 参 数 传 入 ， 并 且 通 过 
getData0 方 法 来 获得 数据 的 细节 。 


2.2.3 ”使 用 意图 对 象 传递 数据 


除了 从 活动 返回 数据 外 ， 也 经 第 需要 传 包 数 据 给 活动 。 例 如 ， 在 前 面 的 示例 中 ， 您 可 能 想 
在 活动 显示 之 前 在 EditText 视 图 中 设置 一 些 坎 认 文本 。 对 此 ， 可 以 使 用 Intent 对 象 将 这 些 数据 传 
递 给 目标 活动 。 下 面 的 “ 试 一 试 ”将 告诉 您 如 何 做 : 


将 数据 传递 给 目标 活动 


(1) 使 用 前 面 创 建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


public boolean onKeyDown(int keyCode, KeyEvent event) 
i 
if (keyCode == KeyEvent.KEYCODE DPAD CENTER) 
{ 
//startActivity(new Intent("net.learn2develop.ACTIVITY2")); 
//startActivity(new Intent(this, Activity2.class)); 
/* 
startActivityForResult(new Intent ( 
"net.learn2develop.ACTIVITY2"), 
request Code); 
* Jj 


Intent i = new Intent("net.learn2develop.ACTIVITY2"); 


Bundle extras = new Bundle(); 


extras.putString("Name", "Your name here"); 


48 


i.putExtras (extras); 
startActivityForResult(i, 1); 
} 
return false; 


} 


(2) 在 Activity2.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 
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public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView (R.layout.activity2); 


String defaultName-""; 


Bundle extras - getIntent().getExtras(); 


if (extras!-null) 


{ 


defaultName - extras.getString("Name"); 


} 
//--- 获 得 EditText 视 图 --- 


EditText txt username = 


(EditText) findViewById(R.id.txt username); 


txt username.setHint (defaultName); 


//--- 获 得 OK 按钮 --- 


Button btn = (Button) findViewById(R.id.btn OK); 


//---oK 按 钮 的 事件 处 理 程序 --- 


btn.setOnClickListener(new View.OnClickListener() 


"P IPM 
H)? 
} 


(3) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 当 单 击 方 
向 键盘 的 中 间 按钮 时 ， 可 注意 到 目标 活动 中 的 EditText 视 图 
显示 了 提示 文本 (如 图 2-17 所 示 )。 


注意 : 提示 文本 是 EditText 视 图 中 常见 的 占 
位 符 文本 。 它 在 视图 为 空 时 显示 ,一旦 有 用 户 输 
入 ， 它 就 会 消失 。 它 用 于 显示 提示 人 信息， 告诉 用 
户 应 该 输入 什么 类 型 的 信息 。 


示例 说 明 


要 使 用 Intent 对 象 给 目标 活动 传递 数据 ， 需 要 使 用 Bundle 


Bundle extras = new Bundle(t); 


8^ 5535:Android 2.3 Emulator 


MLCLIVILW a 
Please enter your name 


图 2-17 
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extras.putString("Name", "Your name here"); 


l.putExtras (extras); 


Bundle 对 象 本 质 上 是 一 个 字典 对 象 ， 使 您 可 以 用 键 / 值 对 的 方式 设置 数据 。 在 这 里 ， 创 建 一 
个 名 为 Name 的 键 并 赋 给 其 值 为 Your name here。 然 后 使 用 putExtras() 方 法 将 Bundle 对 象 添 加 给 
Intent £& . 

在 目标 活动 中 ， 表 先 使 用 getIntent(O 方 法 来 获取 局 动 该 活动 的 意图 ， 然 后 使 用 putExtras() 方 
法 来 获取 Bundle 对 象 : 


Bundle extras — getIntent().getExtras(); 
if (extras!-null) 
{ 
defaultName = extras.getString("Name"); 


} 


getString() 方法 从 Bundle 对 象 中 检索 Name 键 。 然 后 ， 使 用 setHint() J7 法 将 检索 到 的 字符 串 赋 
给 EditText 视 图 。 
//--- 获 得 EdqitText 视 图 --- 
EditText txt username = 
(EditText) findViewById(R.id.txt username); 


txt username.setHint (defaultName); 


2.3 fe HREEISRHP NRI 


到 目前 为 止 ， 您 已 经 了 解 了 如 何在 自己 的 应 用 程序 中 调用 活动 。Android 编 程 的 关键 方面 之 
一 就 是 使 用 意图 从 其 他 应 用 程序 中 调用 活动 。 特 别 是 ， 您 的 应 用 程序 可 以 调用 Android 设 备 内 置 
的 许多 应 用 程序 。 例 如 ， 如 果 您 的 应 用 程序 需要 使 用 户 能 够 呼叫 保存 在 Contacts 应 用 程序 中 特定 
的 一 个 人 人， 那么 您 只 需要 使 用 一 个 Intent 对 象 调 用 Contacts 应 用 程序 ， 用 户 可 以 通过 它 选择 要 通 
话 的 人 。 这 将 使 您 的 应 用 程序 具有 一 致 的 用 户 体 验 ， 避 免 再 建立 另 一 个 应 用 程序 在 Contacts 应 用 
程序 中 检索 所 有 的 联系 人 。 

下 面 的 “ 试 一 试 ” 将 演示 如 何 调用 Android 设 备 中 一 些 常见 的 内 置 应 用 程序 。 


使 用 意图 调用 内 置 应 用 程序 
Intents.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 目 并 命名 为 Intents。 
(2) 在 main.xml 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


«?xml version-"1.0" encoding-"utf-8"?- 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" > 

«Button 
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android: 


id="@+id/btn webbrowser" 


android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Web Browser" /> 
«Button 
android:id-"(tid/btn makecalls" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Make Calls" /» 
«Button 
android:id-"(-id/btn showMap" 
android:layout width-"ftill parent" 
android:layout height-'"wrap content" 
android:text-"Show Map" /» 
«Button 
android:id-"(trid/btn chooseContact" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Choose Contact" /» 
«/LinearLayout» 
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(3) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Intents; 


import 


import 


import 
import 
import 
import 
import 
import 
import 


public 


android 


android 


android. 
android. 
android. 
android. 
android. 
android. 
android. 


.app.Activity; 


.oOs.Bundle; 


content.Intent; 

net.Uri; 
provider.ContactsContract; 
view.View; 
view.View.OnClickListener; 
widget.Button; 
widget.Toast; 


class MainActivity extends Activity I 


Button b1, b2, b3, b4; 
int request Code = 1; 


/[** 当 活 动 第 一 次 被 创建 时 调用 。*/ 


(Override 


public void onCreate(Bundle savedInstanceState) I 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//---Web BrowserjZiíg--- 
bl — (Button) findViewById(R.id.btn webbrowser); 
bl.setOnClickListener (new OnClickListener() 


{ 


public void onClick(View arg0) { 


活动 和 意图 
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Intent i = new 
Intent(android.content.Intent.ACTION VIEW, 


Uri.parse("http://www.amazon.com")); 


startActivity (1i); 


)); 
//---Make Calls 按 钮 --- 
b2 = (Button) tindViewById(R.id.btn makecalls); 
b2.setOnClickListener (new OnClickListener() 
{ 
public void onClick(View argO)( 


Intent i - new 
Intent(android.content.Intent.ACTION DIAL, 


Uri.parse("tel:-651234567")); 
startActivity (i); 


H; 
//---Show Map 按 钮 --- 

b3 = (Button) findViewById(R.id.btn showMap); 
b3.setOnClickListener (new OnClickListener() 


{ 
public void onClick(View argO0)( 


Intent i = new 
Intent(android.content.Intent.ACTION VIEW, 


Uri.parse("geo:37.827500,-122.481670")); 
startActivity (1); 


h); 
//---Choose Contact 按钮--- 

b4 = (Button) findViewById(R.id.btn chooseContact); 
b4.setOnClickListener (new OnClickListener() 


{ 
public void onClick(View argO0)( 


Intent i — new 
Intent(android.content.Intent.ACTION PICK); 


i.setType(ContactsContract.Contacts.CONTENT TYPE); 
startActivityForResult(i,request Code); 


); 
) 
public void onActivityResult(int requestCode, int resultCode, Intent data) 
{ 

if (requestCode == request Code) 


i 
1f (resultCode == RESULT OK) 


{ 
Toast.makeText(this,data.getData().toString(), 


Toast.LENGTH SHORT).show(); 


Intent i - new Intent( 
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android.content.Intent.ACTION VIEW, 


Uri.parse(data.getData().toString())); 
startActivity (1i); 


] 
(4) 按 Fl1 键 在 Android 模 拟 器 上 调试 应 用 程序 。 
(5) 单 击 Web Browser 按 钮 在 模拟 需 中 加 载 Browser 应 用 程序 (如 图 2-18 所 示 )。 


8 5556:Android 2.3 Emulator 


» SSS6Android 23 Emulator — 


‘a http://www.amazon.com... * 
Web Browser - - 


amazoncom | 
— 


Make Calls 


show Map 


[Search Amazon.com 
Choose Contact 


Kindle 


#1 Bestselling 
Product or 
Amazon 


? Learn More 


Shop All Departments 


Books 
Movies, Music & Games 


Electronics 


图 2-18 


(6) 单 击 Make Calls 按 钮 ， 加 载 Phone 应 用 程序 (如 图 2-19 所 示 )。 
(7) 类 似 地 ， 单 击 Show Map 按 饪 加载 Maps 应 用 程序 ， 如 图 2-20 所 示 。 
android = a 5554Android_2.3_Emulator_ WithSD 


ts 


s wi IN 1:55 


BE m x» 


Call log Contacts Favorites 


"i Mill Va 
las Homestead 
Valley 


POTE 
evecerejcuburn 


: Marin City |. 
Ji- Beach e Dra a 
上 机 Sausalito = 
d 
$ ] 
GaldenGate 
National 


Recneatorn Area 


Nc pe, 
al^ pure eu] 
e werde 


5 aightt Miss 


zitz'-: 
Tb BIET, 
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(8) 单 击 Choose Contact 按 钮 显示 可 选择 的 联系 人 列表 (如 图 2-21 所 示 )。 选 定 一 个 联系 人 将 显 


示 此 联系 人 的 详细 信息 。 


A M È 1:56 


5 
[- sally Jackson | Call mobile 
W 


969-240-65 


| Email home 
a! Wei-Meng Lee | weimenglee@gmall.com 


Website 


htt p:/^www.learn2develop.net 


content://com.android.contacts/contacts/ 
lookup/O r1-53353D45354733433535/1 


图 2-21 


示例 说 明 
本 例 中 ， 您 看 到 了 如 何 使 用 Intent 类 来 调用 Android 中 的 一 些 内 置 应 用 程序 (例如 Maps、 


Phone. Contacts] Browser). 


在 Android 中 ， 意 图 通 和 党 是 成 对 出 现 的 : 动作 (action) 和 数据 (data)。 动 作 描述 了 要 执行 什 


么 ， 例 如 编辑 一 个 条 目 、 奋 看 一 个 条 目的 内 容 等 。 数 据 则 指定 了 受 影 响 的 对 象 ， 例 如 Contacts 数 
据 库 中 的 东 个 人 。 这 一 数据 被 指定 为 一 个 Uri 对 象 。 
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动作 的 一 些 示例 如 下 : 
€ ACTION VIEW 

€ ACTION DIAL 

€ ACTION PICK 
数据 的 一 些 示 例如 下 : 

e http://www.google.com 

€ tel:+651234567 

€  926e0:37.827500,-122.481670 
e 


content://contacts 


注意 : 2.3.2 节 将 介绍 可 以 定义 并 在 活动 中 使 用 的 数据 类 型 。 


动作 和 数据 对 共同 描述 了 要 执行 的 操作 。 例 如 ， 要 拨 一 个 电话 号 僻 ， 使 用 ACTION_DIAL/ 
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tel:+651234567 对 :， 要 显示 存储 于 手机 中 的 联系 人 列表 ， 使 用 ACTION VIEW/content://contacts 
对 ; 要 从 联系 人 列表 中 选择 一 个 联系 人 人， 使 用 ACTION PICK/content://contacts 对 。 

在 第 1 个 按钮 中 ， 创 建 了 一 个 Intent 对 象 ， 然 后 给 它 的 构造 函数 传递 了 两 个 参数 
数据 : 


动作 和 


Intent 1 = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 


startActivity (i); 

这 里 的 动作 由 android.content.Intent.ACTION_VIEW 和 第 量 表 示 。 使 用 Uri 类 的 parse(0) 方 法 将 一 
个 URL 字 人 符 串 转 换 为 一 个 Un 对 象 。 

android.content.Imtent.ACTION_VIEW 和 常量 实际 上 指 的 是 android.intent.action.VIEW 动 作 ， 所 
以 前 述 代码 可 以 重 写 为 : 


Intent i = new 
Intent ("android.intent.action.VIEW", 
Uri.parse("http://www.amazon.com")); 
startActivity (i); 


前 面 的 代码 片段 还 可 以 按 如 下 方式 改写 : 


Intent 1 = new 
Intent("android.intent.action.VIEW"); 
i.setData(Uri.parse("http://www.amazon.com")); 


startActivity (i); 


在 这 里 ， 我 们 使 用 setData0 方 法 单独 设置 了 数据 。 
对 于 第 2 个 按钮 ， 我 们 通过 在 数据 部 分 传 入 一 个 电话 号 码 来 拨 出 一 个 特定 的 号 码 : 


Intent i - new 
Intent(android.content.Intent.ACTION DIAL, 
Uri.parse("tel:4-651234567")); 
startActivity (i); 


这 时 ， 拨 号 程序 将 显示 被 呼 叫 的 号 但 。 用 户 仍旧 要 按 拨 号 按钮 来 拨 出 这 个 号 全。 如 果 想 无 
需 用 户 干 预 而 直接 拨 出 号 合 ， 则 要 修改 动作 如 下 : 


Intent i = new 
Intent(android.content.Intent.ACTION CALL, 
Uri.parse("tel:-651234567")); 
startActivity (i); 


注意 : 如 果 想 让 应 用 程序 直接 呼叫 特定 号 码 ， 需 要 为 应 用 程序 添加 android. 


permission. CALL PHONE 权 限 ， 


如 果 仅 仅 只 是 显示 拨号 程序 ， 而 不 指定 任何 号 码 ， 只 要 像 下 面 这 样 省 略 数据 部 分 即 可 : 


Intent i = new 
Intent (android.content.Intent.ACTION DIAL); 
startActivity(i); 
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第 3 个 按钮 使 用 Action VIEW 常量 显示 了 一 个 地 图 : 


Intent i 三 new 
Intent(android.content.Intent.ACTION VIEW, 
Uri.parse("geo:37.827500,-122.481670")); 
startActivity(i); 

这 里 ， 要 使 用 geo 模 式 来 代替 http。 

第 4 个 按钮 调用 Contacts 应 用 程序 来 使 得 用 户 可 以 选择 一 个 联系 人 。 由 于 是 让 用 户 来 选择 一 个 
联系 人 ， 因 此 需要 Contacts 应 用 程序 返回 一 个 值 。 在 这 里 ， 需 要 设置 数据 的 类 型 以 表明 需要 返回 哪 
种 数据 : 

Intent i = new 
Intent (android.content.Intent.ACTION PICK); 


l.setType(ContactsContract.Contacts.CONTENT TYPE); 
startActivityForResult(i,request Code); 


如 果 只 是 想 碍 看 和 选择 那些 有 电话 号 但 的 联系 人 ， 可 以 按 如 下 方式 设置 类 型 : 


i.setType( 
ContactsContract.CommonDataKinds.Phone.CONTENT TYPE); 


这 样 ， 将 显示 联系 人 和 他 们 的 电话 号 码 ( 如 图 2-22 所 示 )。 


a ë 555ġArndroid_2.3_Emulator 


sally Jackson 


Home 345-553-43 


Wei-Meng Lee 


Mobile 969-240-65 


图 2-22 


由 于 希望 从 Contacts 应 用 程序 返回 结果 ， 因 此 使 用 startActivityForResult0 方 法 ， 传 入 Intent 对 
象 和 请 求 但 来 调用 它 。 震 要 实现 onActivityResult0 方 法 来 从 活动 中 获得 络 末 : 


public void onActivityResult(int requestCode, 
int resultCode, Intent data) 
i 

if (requestCode == request Code) 

{ 

if (resultCode == RESULT OK) 
{ 
Toast.makeText(this,data.getData().toString(), 
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Toast.LENGTH SHORT) -Show () 7 
Intent i = new Intent( 
android.content.Intent.ACTION VIEW, 
Uri.parse(data.getData().toString())); 
StartActivity(1i); 


] 


在 Contacts 应 用 程序 中 ， 当 (使 用 ACTION_PICK 和 弟 量 ) 选 择 一 个 特定 的 联系 人 时 ， 将 返回 一 个 
包含 所 选 联系 人 的 URL， 如 下 所 示 : 


content://com.android.contacts/contacts/loopup/0r1-1234567890/1 


获取 这 个 URL 没 有 多 大 用 处 ， 除 非 您 知道 用 它 来 做 什么 。 因 此 ， 在 这 种 情况 下 ， 可 以 创建 
男 一 个 Intent 对 象 来 查看 它 : 


Intent 1 = new Intentt 
android.content.Intent.ACTION VIEW, 


Uri.parse(data.getData().toString())); 
startActivity(i); 


2.3.1 理解 意图 对 象 


到 目前 为 止 ， 您 已 经 了 解 了 Intent 对 象 调 用 其 他 活动 的 作用 。 现 在 正好 可 以 回顾 一 下 并 对 
Intent 对 象 如 何 施展 它 的 魔力 获得 更 详细 的 认识 。 
首先 ， 我 们 可 以 通过 传递 一 个 动作 给 一 个 Intent 对 象 的 构造 函数 来 调用 另 一 个 活动 : 


startActivity (new Intent("net.learn2develop.ACTIVITY2") ) 7; 


动作 (本 例 中 是 netlearn2develop.ACTIVITY2) 也 被 称 为 组 件 名 称 ， 用 来 标识 所 要 调用 的 目标 活 
动 /应 用 程序 。 也 可 以 通过 指定 存在 于 项 目 中 的 活动 的 类 名 修改 组 件 的 名 称 ， 如 下 面 的 代码 所 未 : 
startActivity(new Intent(this, Activity2.class)); 
述 可 以 通过 传 入 一 个 动作 音量 和 数据 来 创建 一 个 Intent 对 象 ， 例 如 : 


Intent 1 = new 
Intent(android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 


startActivity (i); 


动作 部 分 定义 了 您 要 干什么 ， 而 数据 部 分 包含 了 目标 活动 执行 的 数据 。 也 可 以 使 用 setData() 
方法 传递 数据 给 Intent 对 人 象 : 
Intent i - new 


Intent(android.content.Intent.ACTION VIEW); 


i.setData(Uri.parse("http://www.amazon.com")); 


of 
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在 本 例 中 ， 您 表示 要 查看 指定 URL 的 Web 页 面 。Android 操 作 系 统 会 查找 所 有 可 以 满足 您 要 
求 的 活动 。 这 一 过 程 被 称 为 意图 解析 (intent resolution)。2.3.2 节 将 详细 讨论 您 的 活动 是 如 何 成 为 
其 他 活动 的 目标 的 。 

对 十 某 些 意 图 是 无 顷 指 定数 据 的 。 例如 ， 要 从 Contacts 应 用 程序 中 选择 一 个 联系 人 ， 可 指定 
该 动作 ， 然 后 使 用 setType(0) 方 法 表明 MIME 类 型 : 

Intent i 三 new 


Intent (android.content.Intent.ACTION PICK); 
l.setType(ContactsContract.Contacts.CONTENT TYPE); 


setType() 方 法 显 式 指定 了 MIME 数 据 类 型 来 表明 要 返回 的 数据 类 型 。ContactsContract. 
Contacts.CONTENT_TYPE 的 MIME 类 型 是 vnd.android.cursor.dir/contact。 

除了 指定 动作 、 数 据 和 类 型 外 ，Intent 对 象 还 可 以 指定 类 别 。 将 活动 按 类 别 分 组 为 逻辑 单 
元 ， 可 以 实现 Android 对 活动 的 进一步 策 选 。2.3.2 贡 将 更 详细 地 讨论 关 别 。 

总 的 来 说 ，Intent 对 和 象 可 以 包含 以 下 信息 : 


e 动作 
e Xj 
e X 
e 类别 


2.3.2. ARRIR 


之 前 ， 您 已 经 看 到 了 一 个 活动 是 如 何 使 用 Ptent 对 象 调用 另 一 个 活动 的 。 为 了 使 其 他 活动 调用 
您 的 活动 ， 需 要 在 AndroidManifest.xml 文 件 的 <intent-filter> 元 素 中 指定 动作 和 类 别 ， 如 下 所 示 : 
«intent-filter-? 
«action android:name-"net.learn2develop.ACTIVITY2" /> 
«category android:name-"android.intent.category.DEFAULT" /» 
«/intent-filter» 


这 是 一 个 活动 使 用 net.learn2develop.ACTIVITY2 动 作 调用 另 一 个 活动 的 非 芝 简单 的 示例 。 
面 的 “ 试 一 试 ” 则 提供 了 一 个 更 复杂 的 示例 。 


更 详细 地 指定 意图 筛选 器 


4 E Intents 


(1) 使 用 先前 创建 的 Intents 项 目 ， 给 该 项 目 添加 一 个 新 类 ， 并 命名 为 a (9 src 


4 Hj net.earn2develop.Intents 


MYBrowserActivity.java。 在 res/layout 文 件 严 下 再 新 增 一 个 XML 文件 ， 命 nc EE 
名 为 browser.xml( 如 图 2-23 所 示 )。 Gepa 
a ass 
(2) 在 AndroidManifestxml 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 8e 
t [2 drawable-hdpi 
<?xml version-"1.0" encoding-"utf-8"?» í ai pania 
«manifest xmlns:android-"http://schemas.android.com/ Ef - 
apk/res/android" 四 mainxml — 
package-"net.learn2develop.Intents" E 


default.properties 
proguard.cfg 


[k| 2-23 
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android:versionCode-"]" 
android:versionName-"1.0"- 
«application android:icon-"8drawable/icon" android:label-"8string/app name"- 
«activity android:name-".MainActivity" 
android:label-"Q8string/app name"» 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«activity android:name-".MyBrowserActivity" 
android:label-"8(string/app name"? 
«intent-filter- 
«action android:name-"android.intent.action.VIEW" /> 
«action android:name-"net.learn2develop.MyBrowser" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«data android:scheme-"http" /> 
«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"9" /> 
«uses-permission android:name-"android.permission.CALL PHONE" /> 
«uses-permission android:name-"android.permission.INTERNET" /» 
«/manifest» 


(3) fEmain.xml X fF 8E P ZB HAS Sz KARA: 


<?xml version-"1.0" encoding-"utf-8"?-» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" > 
«Button 
android:id-"Q-c-id/btn webbrowser" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Web Browser" /» 
«Button 
android:id-"8-c-id/btn makecalls" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Make Calls" /» 
«Button 
android:id-"8-c-id/btn showMap" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Show Map" /> 
«Button 
android:id="@+id/btn chooseContact" 


android:layout width-"fill parent" 


Android N ai 


android:layout height-"wrap content" 

android:text-"Choose Contact" /> 
«Button 

android:id-"(t-id/btn launchMyBrowser" 

android:layout width-"fill parent" 

android:layout height-"wrap content" 

android:text-"Launch My Browser" /» 
«/LinearLayout» 


(4) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Intents; 


import android.app.Activity; 

import android.content.Intent; 

import android.net.Uri; 

import android.os.Bundle; 

import android.provider.ContactsContract; 
import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


import android.widget.Toast; 
public class MainActivity extends Activity { 


Button bl, b2, b3, b4, bb; 
int request Code = 1; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//---Web Browse 按钮 --- 
bl = (Button) findViewById(R.id.btn webbrowser); 


bl.setoOnClickListener(new OnClickListener() 


//---Make CallsiEÍH--- 
b2 = (Button) findViewById(R.id.btn makecalls); 


b2.setonClickListener(new OnClickListener() 


//---Show Map 按 钮 ---- 
b3 — (Button) findViewById(R.id.btn showMap); 
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b3.setOnClickListener(new OnClickListener() 


//---Choose ContactiZEtH--- 


b4 — (Button) findViewById(R.id.btn chooseContact); 


b4.setOnClickListener(new OnClickListener () 


b5 — (Button) findViewById(R.id.btn launchMyBrowser); 
b5.setOnClickListener (new OnClickListener() 


{ 
public void onClick(View arg0) 
t 
Intent i - new 


Intent("net.learn2develop.MyBrowser"); 
i.setData(Uri.parse("http://www.amazon.com")); 


startActivity (i); 


)); 


public void onActivityResult(int requestCode, int resultCode, Intent data) 
{ 
a 


(5) 在 browser.xml 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" > 
«WebView 
android:id-"(trid/WebViewO01" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 
</LinearLayout> 


(6) 在 MyBrowserActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.Intents; 


import android.app.Activity; 
import android.net.Uri; 
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import android.os.Bundle; 
import android.webkit.WebView; 
import android.webkit.WebViewClient; 


publico class MyBrowserActivity extends Activity ( 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
GOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.browser); 


Uri url - getIntent().getData(); 

WebView webView = (WebView) findViewById(R.id.WebViewO1); 
webView.setWebViewClient(new Callback()); 
webView.loadUrl(url.toString()); 


private class Callback extends WebViewClient [( 
GOverride 
public boolean shouldOverrideUrlLoading (WebView view, String url) ( 


return(false); 


(7) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 
(8) 单 击 Launch my Browser 按 钮 ， 将 会 看 到 显示 看 Amazon.com 的 Web 页 面 的 一 个 新 活动 (如 
图 2-24 所 示 )。 


| m3 5554:Android 2.3 Emulator WithSD 


Intents 


X3 Cart | Wish List 


Eco, 
Kindle 


#1 Bestselling 
Product on 
Amazon 

* Learn More 


Shop All Departments 
Books 
Movies, Music & Games 
Electronics 


See All Departments 
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示例 说 明 


在 本 例 中 ， 创 建 了 一 个 名 为 MyBrowsefrActivity 的 新 活动 。 首 先 需 要 在 AndroidManifest.xml 
文件 中 声明 它 。 


«activity android:name-".MyBrowserActivity" 
android:label-"Q8string/app name"- 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
«action android:name-"net.learn2develop.MyBrowser" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«data android:scheme-"http" /» 
«/intent-filter» 
«/activity» 


在 <intent-filter> 元 素 中 ， 声 明了 活动 的 两 个 动作 、 一 个 类 别 以 及 一 个 数据 。 这 意味 看 所 有 
其 他 活动 可 以 使 用 android.intent.action.VIEW 或 net.learn2develop.MyBrowser 动 作 来 调用 这 个 活 
动 。 对 于 所 有 和 希望 别人 使 用 startActivity0) 或 startActivityForResultO 方 法 来 调用 的 活动 ， 它 们 需要 
具有 android.intent.category.DEFAULT 类 别 。 如 果 没 有 的 话 ， 您 的 活动 将 不 能 被 其 他 活动 调用 。 
<data> 元 素 指 定 了 活动 期 望 的 数据 类 型 。 在 本 例 中 ， 它 期 望 的 数据 要 以 http:// 前 级 打头 。 

先前 的 意图 病 选 句 还 可 以 按 如 下 方式 改写 : 


«activity android:name-".MyBrowserActivity" 
android:label-"8(string/app name"? 
«intent-filter» 
«action android:name-"android.intent.action.VIEW" /> 
«category android:name-'"android.intent.category.DEFAULT" /> 
«data android:scheme-"http" /> 
«/intent-filter» 
«intent-fhtilter- 
«action android:name-"net.learn2develop.MyBrowser" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«data android:scheme-"http" /> 
«/intent-filter» 
«/activity» 


*» 3554Àndroid 2.3 Emulator WitFSD 


按 这 种 方式 编写 意图 筛选 器 可 以 对 一 个 意图 筛选 器 中 的 
动作 、 类 列 以 及 数据 进行 逻辑 分 组 ， 使 其 更 加 具有 可 读 性 。 
现在 如 果 使 用 带 有 如 下 数据 的 ACTIION_VIEW 动 作 ，Android 


Intent i = new æ Intents 
Intent (android. content. Intent .ACTION VIEW, 


Uri.parse("http://www.amazon.com")); 


E Use by default for this action. 


startActivity(i); 


可 以 在 使 用 Browser 应 用 程序 还 是 当前 正在 构建 的 Intents 
应 用 程序 间 进 行 选择 。 
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2.3.3 添加 类 别 


可 以 在 意图 沛 选 右 中 使 用 <category> 元 到 对 活动 进行 分 类 。 假 设 已 经 在 AndroidManifest.xml 
文件 中 添加 了 下 列 <category> 元 素 : 


«?xml version-"1.0" encoding-"utfí-8"?- 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Intents" 
android:versionCode-"]" 
android:versionName-"1.0"-» 
«application android:icon-"8drawable/icon" android:label-"8string/app name"> 
«activity android:name-".MainActivity" 
android:label-"G8string/app name"» 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«activity android:name-".MyBrowserActivity" 
android:label-"G8string/app name"» 
«intent-filter- 
«action android:name-"android.intent.action.VIEW" /» 
«action android:name-"net.learn2develop.MyBrowser" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«category android:name-"net.learn2develop.Apps" /> 
«data android:scheme-"http" /» 
«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"9" /» 
«uses-permission android:name-"android.permission.CALL PHONE" /> 


«uses-permission android:name-"android.permission.INTERNET" /» 


«/manifest-» 
在 这 种 情况 下 ， 下 列 代 码 将 调用 MyBrowserActivity 活 动 : 


Intent i 三 new 
Intent(android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 
i.addCategory("net.learn2develop.Apps"); 
startActivity(1i); 


fiti FHaddCategory O77 134 K nl is Jn $Intent] P. A S iW f addCategoryO it. Bii 
述 的 代码 仍旧 会 调用 MyBrowserActivity 活 动 ， 因 为 它 仍 日 和 默认 类 别 android.intent.category. 
DEFAULTIL Ht. 
^ii. WRI S T RAE a P EX BIAIS ULBCGHIAS A. nhe S CH: 
Intent i = new 
Intent ("net.learn2develop.MyBrowser", 


Uri.parse("http://www.amazon.com")); 


/ | — -这 个 类 别 不 匹配 意图 筛选 器 中 的 任何 类 别 --- 
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i.addCategory ("net.learn2develop.OtherApps"); 
startActivity (i); 


FIRJ ll (et.learn2develop.OtherApps) ^ UL We zs Fd dried P FERIIS. MAKSA 
运行 时 异常 。 
如 果 在 MyBrowserActivity 的 意图 筛选 器 中 试 加 前 述 类 别 ， 先 前 的 代码 承 可 以 运行 了 : 
«intent-dlilter- 
«action android:name-"android.intent.action.VIEW" /> 
«action android:name-"net.learn2develop.MyBrowser" /» 
«category android:name-"android.intent.category.DEFAULT" /> 
«category android:name-"net.learn2develop.Apps" /» 
«category android:name-"net.learn2develop.OtherApps" /> 
«data android:scheme-"http" /> 
«/intent-filter» 


可 以 添加 多 个 类 别 到 一 个 Intent 对 象 中 ， 以 下 语句 在 mmtent 对 象 中 添加 了 net.learn2 develop. 
SomeOtherApps 类 别 : 


Intent i = new 
Intent("net.learn2develop.MyBrowser", 
Uri.parse("http://www.amazon.com")); 
l1.addCategory("net.learn2develop.OtherApps"); 
i.addCategory ("net.learn2develop.SomeOtherApps"); 
startActivity(1i); 


由 于 意图 筛选 器 没有 定义 netleam2develop.SomeOtherApps 类 别 ， 上 述 代码 将 不 能 调用 MyBrowser- 
Activity 活 动 。 为 此 ， 需 要 再 一 次 添加 netleam2develop.SomeOtherApps 类 别 到 意图 筛选 器 中 。 

从 这 个 示例 可 以 看 出 ， 在 一 个 活动 可 以 被 调用 之 前 ， 当 使 用 一 个 带 有 类 别 的 意图 对 象 时 ， 
所 有 添加 到 Intent 对 象 的 类 别 必 须 完全 匹配 意图 筛选 器 中 所 定义 的 类 别 。 


2.4 显示 通知 

到 目前 为 止 ， 您 一 直 使 用 Toast 类 来 给 用 户 显 示 消 息 。Toast 关 虽然 是 一 个 加 用 户 显 示警 报 的 
方便 的 方法 ， 但 它 不 能 持久 。 它 只 是 在 屏 具 上 办 那么 几 秒 钟 后 束 消 失掉 了。 用户 如 果 不 一 卫 采 
AR HERES TERERAA MIRED L. 

TERNAR, EHEAR. A R, MEH NotificationManagertE 


wA TU HS] AN es ES CE ERA XB ALES) FU IS RRA fe s PIE] GAA” HR S a 
做 到 这 一 点 。 


在 状态 栏 上 显示 通知 
INotifications.zip 代 , 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 目 并 命名 为 Notifications。 
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(2) 在 项 目的 src 文 件 夹 下 添加 一 个 新 的 类 文件 NotificationView. | “号 
java( 如 图 2-26 所 示 )。 男 外 ， 在 res/layout 文 件 夹 下 添加 一 个 新 的 
notification.xml 文 件 。 

(3) 按 如 下 所 示 填 充 notification.xml 文 件 : 


<?xml version-"1.0" encoding-"utfí-8"?-» 
«LinearLayout xmlns:android-"http://schemas.android. 
com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" > 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Here are the details for the notification 


«/LinearLayout» 


(4) 按 如 下 所 示 填 充 NotificationView.java 文 件 : 


package net.learn2develop.Notifications; 


import android.app.Activity; 
import android.app.NotificationManager; 
import android.os.Bundle; 


public class NotificationView extends Activity 
{ 
QGOverride 
public void onCreate (Bundle savedInstanceState) 
i 
super.onCreate(savedInstanceState); 


setContentView(R.layout.notification); 


//--- 查 找 通 知 管理 器 服务 --- 
NotificationManager nm = (NotificationManager) 
getSystemService (NOTIFICATION SERVICE); 


//--- 取 消 已 经 开始 的 通知 


Notifications 

[B src 

4 Hj netlearn2develop.Notifications 
» [T] MainActivity.java 
e |D] MotificationView.java| 


b E8 gen [Generated Jawa Files] 
» =Œ} Android 2.3 


d» assets 
E> res 

t EE drawable-hdpi 
t EE drawable-ldpi 

:EE drawable-mdpi 
4 EE layout 


IX| main.xml 


| [X] notification.xml| 
b = values 
yil AndroidManifest.xml 
default.properties 
proguard.cfg 


图 2-26 


Q.ÉÁM /> 


nm.cancel(getlIntent().getExtras().getlInt("notificationID")); 


(5) 在 AndroidManifest.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


«?xml version-"1.0" encoding-"utf-8"?- 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"net.learn2develop.Notifications" 
android:versionCode-"]" 


android:versionName-"1.0"- 
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«application android:icon-"8(drawable/icon" android:label-"8string/app name"> 
«activity android:name-".MainActivity" 
android:label-"Qstring/app name"- 
«intent-filter» 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«activity android:name-".NotificationView" 
android:label-"Details of notification" 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"9" /> 
«uses-permission android:name-"android.permission.VIBRATE" /> 
«/manifest» 


(6) 在 main.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
<?xml version-"1.0" encoding-"utf-8"?- 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 

android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" > 
«Button 
android:id-"(*id/btn displaynotif" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Display Notification" /> 
«/LinearLayout» 


(7) 最 后 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Notifications; 


import android.app.Activity; 

import android.os.Bundle; 

import android.app.Notification; 

import android.app.NotificationManager; 
import android.app.PendingIntent; 
import android.content.Intent; 

import android.view.View; 

import android.widget.Button; 


public class MainActivity extends Activity I 
int notificationID = 1; 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
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8Q8Override 


public void onCreate(Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


Button button = (Button) findViewById(R.id.btn displaynotif); 
button.setOnClickListener (new Button.OnClickListener() 1 
public void onClick(View v) ( 
displayNotification(); 
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protected void displayNotification() 


{ 


//--- 如 果 用 户 选 择 这 个 通知 ， 使 用 PendingIntent 来 启动 活动 --- 
Intent i - new Intent(this, NotificationView.class); 
i.putExtra("notificationID", notificationID); 


PendingIntent pendingIntent - 
PendinglIntent.getActivity(this, 0, i, 0); 


NotificationManager nm = (NotificationManager) 
getSystemService (NOTIFICATION SERVICE); 


Notification notif - new Notification( 
R.drawable.icon, 
"Reminder: Meeting starts in 5 minutes", 
System.currentTimeMillis()); 


CharSequence from = "System Alarm"; 


CharSequence message = "Meeting with customer at 3pm..."; 
notif.setLatestEventInfo(this, from, message, pendingIntent); 
//--- 延 迟 100 毫 秒 ， 震 动 250 毫 秒 ， 暂 停 100 宫 秒 ， 然 后 震动 500 毫 秒 --- 


notif.vibrate = new long[] { 100, 250, 100, 500}; 
nm.notify(notificationID, notif); 


(8) 按 F11 键 在 Android 横 拟 器 上 调试 应 用 程序 。 

(9) 单 击 Display Notification 按 钮 ( 见 图 2-27 左 上 侧 )， 状 态 栏 上 将 出 现 一 个 通知 。 
(10) 单 击 并 向 下 拖 搜 状态 栏 将 显示 该 通知 ( 见 图 2-27 右 侧 )。 

(11) 单 击 通 知 将 显示 NotificationView 活 动 。 同 时 也 将 把 通知 从 状态 栏 上 清除 。 
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s^ S554Ardroid 2.3 Emuleter WithsD s ^ S554 ndroid 2.3 Emulator WithsD 


BR reminder: meeting starts in 5 minutes January 3, 2011 


Display Matification s 


^s System Alarm 


图 2-27 
示例 说 明 
要 显示 一 个 通知 ， 首 先 要 创建 一 个 指 癌 NotificationView 类 的 Intent 对 象 : 


/ /一 -如 果 用 户 选 择 这 个 通知 ， 使 用 PendingIntent 来 启动 活动 ---- 
Intent i = new Intent(this, NotificationView.class); 


i.putExtra("notificationID", notificationID); 


当 用 户 从 通知 列表 中 选择 了 一 个 通知 时 ， 这 个 意图 将 被 用 来 启动 另 一 个 活动 。 在 这 个 示例 
中 ， 给 Intent 对 象 添加 一 个 键 / 值 对 可 以 用 来 标记 通知 ID， 标 识 目 标 活 动 的 通知 。 这 个 ID 将 在 以 
后 用 来 撤销 这 个 通知 。 
还 需要 创建 一 个 PendingIntent 对 象 。PendingIntent 对 象 可 以 代表 应 用 程序 帮助 您 在 后 面 茶 个 
时 候 执 行 一 个 动作 ， 而 不 用 考虑 应 用 程序 是 否 正 在 运行 。 在 这 里 ， 按 如 下 所 示 初 始 化 它 : 
PendingIntent pendingIntent = 
PendingIntent.getActivity(this, 0, i, 0); 


getActivity(0) 方 法 检索 一 个 PendingImtent 对 象 并 使 用 如 下 参数 设置 它 : 

e EFX 应 用 程序 上 下 文 

e ”请求 码 一 一 用 于 意图 的 请 求 码 

e 意图 一 一 用 来 启动 目标 活动 的 意图 

@ ”标志 一 一 活动 启动 时 使 用 的 标志 

然后 ， 获 取 一 个 NotificationManger 类 的 实例 并 创建 一 个 Notiftication 类 的 实例 : 


NotificationManager nm - (NotificationManager) 
getSystemService (NOTIFICATION SERVICE); 


Notification notif = new Notification( 


R.drawable.icon, 
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"Reminder: Meeting starts in 5 minutes", 
System.currentTimeMillis()); 


当 通 知 诈 次 显示 在 状态 栏 上 时 ，Notiftication 类 使 您 能 8^ 5554Android_ 2.3 Emulator. WithSD 
够 指定 通知 的 主要 信息 。Notifcation 构 造 函 数 的 第 二 个 参 
数 在 状态 栏 上 设置 了 “滚动 文本 ”( 如 图 2-28 所 示 )。 

接 下 来 ， 使 用 setLatestEventInfo() 方 法 来 设置 通知 的 
详细 内 容 : 


" Reminder: iecur ls starts in 5 minutes 


CharSequence from = "System Alarm"; 

CharSequence message = "Meeting with customer at 3pm..."; 
notif.setLatestEventInfo(this, from, message, pendingIntent); 
//--- 延 迟 100 毫 秒 ， 震 动 250 毫 秒 ， 暂 停 100 毫 秒 ， 然 后 震动 500 毫 秒 --- 
notif.vibrate = new long[] { 100, 250, 100, 500); 


上 述 代码 还 将 通知 设置 为 震动 手机 。 最 后 ， 使 用 notify() 方 法 来 显示 通知 。 


nm.notify(notificationID, notif); 


当 用 户 单 击 通 知 时 ，NotificationView 酒 动 束 会 启动 。 这 里 ， 使 用 NotificationManager 对 人 象 的 
cancel0 方 法 并 传递 给 它 通知 的 ID( 通 过 Intent 对 象 传递 ) 来 取消 这 个 通知 : 
//--- 查 找 通 知 管理 器 服务 --- 


NotificationManager nm = (NotificationManager) 
getSystemService (NOTIFICATION SERVICE); 


//--- 取 消 已 经 开始 的 通知 
nm.cancel(getlIntent().getExtras().getlInt("notificationID")); 


2.5 本章 小 结 


本 章 首 先 详 细 介 绍 了 活动 是 如 何 工 作 的 以 及 用 于 显示 它们 的 各 种 形式 。 您 还 了 解 了 如 何 使 
用 活动 来 显示 对 话 框 窗口 。 

本 章 第 二 部 分 冰 述 了 Android 中 的 一 个 非常 重要 的 概念 一 意图。 意图 是 使 不 同 活动 连接 起 
来 的 “胶水 ”， 也 是 为 Android 平 台 进行 开发 需要 了 解 的 一 个 关键 概念 。 


1. ”如 果 有 两 个 或 多 个 活动 具有 相同 的 意图 筛选 嚣 名称， 那 将 会 发 生 什 么 ? 
2. ” 写 一 段 代 码 来 调用 内 置 的 Browser 应 用 程序 。 

3. ”在 意图 筛选 需 中 ， 可 以 指定 哪些 组 成 部 分 ? 

4. Toast 类 和 NotificationManager 类 的 区 别 是 什么 ? 


ro 


第 2 章 AJMARE 


本 章 主要 内 容 


创建 活动 所 有 活动 必须 在 AndroidManifestxml 文 件 中 声明 

活动 的 关键 生命 周期 Rete ir Porc UE 当 活 动 被 停止 或 转 
以 对 话 框 形式 显示 活动 使 用 showDialog0) 方 法 并 实现 onCreateDialog() 方 法 

EE 连接 不 同 活动 的 “胶水 ” 

意图 第 选 器 可 以 使 您 指定 应 当 如 何 调用 活动 的 “筛选 器 ” 

调用 活动 使 用 startActivity0) 或 startActivityForResult0) 方 法 

传递 数据 给 一 个 活动 使 用 Bundle 对 象 

Itent 对 象 中 的 组 成 部 分 Intent 对 象 包含 动作 、 数 据 、 类 型 和 类 别 

显示 通知 使 用 NotificationManager 类 

— PendingIntent 对 象 可 以 代表 应 用 程序 帮助 您 在 后 面 某 个 时 候 执行 一 个 动 


作 ， 而 不 用 考虑 应 用 程序 是 否 正 在 运行 
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本 章 将 介绍 以 下 内 容 
可 以 用 来 布置 视图 的 多 种 视图 组 (ViewGroup) 
如 何 适 应 屏幕 方 回 的 变化 
如 何 管理 屏 硕 方向 的 变化 
如 何以 编程 方式 创建 用 户 界 面 
如 何 侦 听 用 户 界 面 通知 

在 第 2 章 中 ， 您 已 经 学 习 了 Activity 类 和 它 的 生命 周期 ， 了 解 了 活动 就 是 用 户 用 来 和 应 用 程 
厅 交 互 的 一 个 手段 。 然 而 ， 活 动 本 喘 并 没有 在 屏 各 上 呈现 。 相 反 ， 它 需要 使 用 视图 和 视图 组 来 
绘制 屏幕 。 本 章 将 学 习 有 关 在 Android 中 创建 用 户 界面 的 详细 内 容 ， 以 及 用 己 是 如 何 与 之 交互 
的 。 此 外 ， 还 将 学 习 如 何 处 理 Android 设 备 屏 幕 方 问 的 变化 。 


3.1 TERARI AK 


在 第 2 章 中 ， 您 已 经 知道 了 Android 应 用 程序 的 基本 单元 是 活动 。 活 动 显示 了 应 用 程序 的 用 
户 界面 ， 它 可 以 包 盒 按钮、 标签、 文本 框 等 小 部 件 。 通 利 情 况 下 ， 使 用 一 个 XML 文件 (例如 ， 位 
于 res/layout 文 件 夹 下 的 main.xml 文 件 ) 来 定义 用 户 界 面 ， 类 似 如 下 所 示 : 


<? xml version-z"1.0" encoding-"utf-8"? > 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"ftill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"(string/hello" 
f> 


</LinearLayout> 


运行 时 ， 在 Activity 类 的 onCreate0 事 件 处 理 程序 中 使 用 Activity 类 的 setContentView0) 方 法 加 
载 XML 用户 界面 : 
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QGOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView (R.layout.main); 


] 


在 编译 过 程 中 ，XML 文件 中 的 每 一 个 元 素 被 编译 成 相应 的 Android GUI 类 ， 这 些 类 使 用 方法 
来 表示 属性 。 在 此 文件 被 加 载 后 ，Android 系 统 就 会 创建 活动 的 用 户 界 面 。 


注意 : 尽管 使 用 XML 文件 构建 用 户 界 面 通常 比较 容易 ， 但 有 时 您 还 需要 
在 运行 时 动态 地 构建 用 户 界 面 (例如 ， 编 写 游戏 时 )。 因 此 ， 完 全 用 代码 创建 
用 户 界 面 也 是 可 行 的 方法 。 本 章 稍 后 将 为 您 提供 一 个 示例 ， 演 示 是 如 何 实 现 
这 一 点 的 。 


3.1.1 视图 和 视图 组 


活动 包含 了 视图 和 视图 组 。 视 图 是 一 个 可 以 在 屏幕 上 显现 的 小 部 件 ， 例 如 按钮 、 标 签 和 文 
本 杠 。 视 图 派生 日 基 类 android.view.View。 


一 个 或 多 个 视图 可 以 组 合成 一 个 视图 组 。 视 图 组 (其 本 号 就 是 一 种 特殊 的 视图 类 型 ) 提 
供 了 一 种 布局 ， 您 可 以 按 该 布局 定制 视图 的 外 观 和 顺序 。 视 图 组 的 例子 包括 LinearLayout 和 
FrameLayout。 视 图 组 派生 十 基 类 android.view.ViewGroup。 

Android 文 持 以 下 视图 组 : 
LinearLayout 
AbsoluteLayout 
TableLayout 
RelativeLayout 


FrameLayout 

€ ScrollView 

在 后 面 的 章节 中 将 对 这 每 一 个 视图 组 进行 详细 讨论 。 注 意 ， 在 实践 中 将 不 同类 型 的 布局 组 
合 起 来 创建 想 要 的 用 户 界 和 面 是 很 常见 的 。 


3.1.2 LinearLayout 
LinearLayout 是 以 单行 或 单列 的 形式 排列 视图 的 。 子 视图 可 以 水 平 或 牌 下 地 排列 。 要 了 解 
LinearLayout 是 如 何 工 作 的 ， 请 考虑 main.xml 艾 件 中 通常 包含 的 以 下 元 素 : 


<? xml version-"1.0" encoding="utf-8"? > 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 


android:orientation-"vertical" 
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android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 

«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"(8string/hello" 
/> 


</LinearLayout> 
在 main.xml 文 件 中 ， 可 注意 到 根 元 素 <LinearLayout> 及 其 包含 的 <TextView> 元 素 ， 
<LinearLayout> 元 宗 用 来 控制 其 所 包含 的 视图 的 显示 顺 厅 。 
每 个 视图 和 视图 组 都 有 一 组 公共 属性 ， 其 中 一 些 如 表 3-1 所 示 。 
表 3-1 ”视图 和 视图 组 使 用 的 公共 属性 


属 性 já X 

layout, width Ta xe ES ERAN E] ZH HS s JE 

layout height 指定 视图 或 视图 组 的 高 度 

layout marginTop 指定 视图 或 视图 组 顶 边 额外 的 空间 
layout_marginBottom 指定 视图 或 视图 组 底 边 额外 的 空间 
layout_marginLeft 指定 视图 或 视图 组 左边 御 外 的 空间 
layout_marginRight 指定 视图 或 视图 组 右边 额外 的 空间 
layout. gravity 指定 如 何 定位 子 视图 

layout weight 指定 在 布局 中 应 该 给 视图 分 配 多 少 额 外 空间 
layout, x 指定 视图 或 视图 组 的 x 坐标 
layout_y 指定 视图 或 视图 组 的 y 坐 标 


| 注意 : 以 上 某 些 属性 只 有 当 一 个 视图 在 特定 的 视图 组 中 时 才 适 用 。 例 如 ， 
layout_weight 和 layout_gravity 必 性 只 适用 于 视图 位 于 LinearLayout 或 TableLayout 
视图 组 中 的 情况 。 


ASK, (EHH parent n] UL i-«TextView27U 35 I] 95 SEG SC 76 CI P IR BEARES E 
AEE. wrap content h 5 BH T RRR ERARA PRERA SES MRA 
<TextView> 视 图 占据 一 整 行 ， 可 以 将 其 layout_width 属 性 设置 为 wrap_content， 如 下 所 示 : 

< TextView 
android:layout width-"wrap content 
android:layout height-"wrap content" 


android:text-"(string/hello" 
/> 


这 将 把 视图 的 宽度 设 为 此 视 岁 所 包含 的 文本 的 宽度 。 
考虑 以 下 布局 : 
<? xml version-"1.0" encoding-"utf-8""? > 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 


android:layout width-"fill parent" 
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android:layout height-"fill parent" 
> 

«TextView 
android:layout width-"l05dp" 
android:layout height-"wrap content" 
android:text-"8string/hello" 
/ > 

«Button 
android:layout width-"leOdp" 
android:layout height-"wrap content" 
android:text-"Button" 
/? 


«/LinearLayout» 


度量 单位 


当 指 定 Android 用 户 界面 上 元 素 的 大 小 时 , 应 知道 以 下 度量 单位 : 
e dp——5'€ E Xt% € (density-independent pixel)。160dp 相 当 于 1 英寸 的 屏幕 物 
PRT, 当 在 布局 中 指定 视图 尺寸 时 , 推荐 将 dp 作为 度量 单位 。 当 指 的 是 与 密度 无 关 的 像素 时 ， 


可 以 使 用 dp 或 dip。 
€ sp—— 56455 X 94$ X (scale-independent pixel). 与 dp 类 似 , 推荐 用 于 指定 字体 
大 小 。 


e pt 一 一 磅 ,1 磅 等 于 1/72 英 寸 (基于 屏幕 的 物理 尺寸 )。 
€ px 一 一 像素 ,对 应 于 屏幕 上 的 实际 像素 。 不 建议 使 用 这 一 单位 , 因为 您 的 用 户 界面 在 
不 同 屏 幕 尺寸 的 设备 上 可 能 不 能 正确 呈现 


这 里 ， 将 TextView 和 Button 视 图 的 宽度 都 设置 成 了 一 个 绝对 值 。 在 本 例 中 ，TextView 的 宽 
度 被 设置 为 105dp，Button 的 宽度 被 设置 为 160dp。 图 3-1 展 现 了 在 一 个 分 辨 率 为 320X480 的 模拟 
锅 上 所 观察 到 的 视图 效果 。 

图 3-2 展 现 了 在 一 个 高 分 辩 率 (480X 800) 的 模拟 器 上 所 观察 到 的 视图 效果 。 
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可 以 看 到 ， 在 以 上 两 种 模拟 需 中 ， 两 种 视图 的 宽度 相对 于 模拟 需 的 宽度 而 言 是 一 样 的 。 这 


表明 了 即使 是 不 同 分 辩 率 的 目标 设备 ， 使 用 dp 作为 单位 也 是 有 用 的 ， 可 以 确保 相对 于 设备 的 视 


图 大 小 保持 不 变 。 
上 面 的 例子 还 指 定 了 布局 的 方 丫 是 垂直 的 : 


«LinearLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 

android:layout width-"fill parent" 

android:layout height-"fill parent" 

> 


默认 的 布局 方 回 是 水 平 的 。 因 此 ， 如 果 省 略 android:orientation 属 性 ， 视 图 将 显示 如 图 3-3 所 
示 的 效果 。 
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在 LinearLayout 中 ， 可 以 对 其 中 包含 的 视图 应 用 layout_weight 和 ]ayout_gravity 属 性 ， 可 对 


716 


<? xml version-"1.0" encoding-"utf-8"? > 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:orientation-^"vertical" 


android:layout width-"fill parent" 


android:layout height-"fill parent" 
> 


<TextView 


android:layout width="105dp" 
android:layout height-"wrap content" 
android:text-"(string/hello" 

/> 


«Button 


android:layout width-"le0dp" 


android:layout height-"wrap content" 


android:text-"Button" 


android:layout gravity-"right" 
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android:layout weight="0.2" 
/? 

«EditText 
android:layout width-"ftill parent" 
android:layout height-"wrap content" 
android:textSize-"18sp" 
android:layout weight-"0.8" 
/? 


«/LinearLayout» 


图 3-4 显 示 了 使 用 layout_gravity 属 性 使 按钮 与 其 父 元 素 ( 指 LinearLayoub) 的 右边 对 齐 。 同 时 ， 
使 用 layout_weight 属 性 指定 Button 按 钮 和 EditText 视 图 占 屏 敌 璋 余 空 则 的 比例 。 所 有 layout_weight 
属性 的 值 的 和 必须 为 1。 
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3.1.3 AbsoluteLayout 
AbsoluteLayout 可 用 于 指定 其 子 元 素 的 确切 位 置 。 考 虑 下 列 main.xml 文 件 中 定义 的 用 户 界 面 : 


«? xml version-"1.0" encoding-"utf-8"? > 
«AbsoluteLayout 
android:layout width-"ftill parent" 
android:layout height-"fill parent" 
xmlns:android-"http://schemas.android.com/apk/res/android" 
> 
<Button 
android:layout width-"188dp" 
android:layout height-"wrap content" 
android:text-"Button" 
android:layout x-"126px" 
android:layout y-"36lpx" 
/> 
<Button 
android:layout width-"113dp" 


ff 
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ndroid:layout height-"wrap content" 
ndroid:text-"Button" 


a 

a 

android:layout x-"l2Zpx" 

android:layout y-"36lpx" 
/> 

</AbsoluteLayout> 


赂 3-5 展 示 了 使 用 android_layout_ x 和 android_layout_y 必 性 将 两 个 Button 视 网 定 位 在 指定 的 位 
ELA. 
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B] 3-5 
然而 ， 当 在 高 分 辨 率 的 屏 虹 上 得 看 活动 时 ，AbsoluteLayout 存 在 一 个 问题 (如 图 3-6 所 示 )。 因 
此 ， 从 Android 1.5 以 后 ，AbsoluteLayonut 已 经 被 弃 用 了 (尽管 当前 版 本 仍旧 文 持 它 )。 鉴 于 不 能 保 
证 在 Android 的 未 来 版 本 中 是 否 文 持 此 视图 组 ， 应 该 在 用 户 界面 中 避免 使 用 AbsoluteLayout， 而 
使 用 本 章 描 述 的 其 他 布局 。 
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3.1.4 TableLayout 


TableLayout 以 行 和 列 的 形式 组 织 视图 。 使 用 <TableRow> 元 率 来 指定 表 中 的 某 一 行 。 每 一 行 
可 以 包含 一 个 或 多 个 视图 。 行 内 的 每 个 视图 构成 一 个 单元 格 。 每 一 列 的 宽度 由 此 列 中 最 大 单元 
考虑 下 列 main.xml 文 件 的 内 容 : 


<? xml version="1.0" encoding-"utf-8"? > 

«TableLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout height-"fill parent" 
android:layout width-"fill parent" 
> 
<TableRow> 

«TextView 
android:text-"User Name:" 
android:width -"120px" 

/? 

«EditText 
android:id-"(-cid/txtUserName" 
android:width-"200px" /> 

«/TableRow-» 
«TableRow-^ 

«TextView 
android:text-"Password:" 
/? 

«EditText 
android:id-"(ü-cid/txtPassword" 
android:password-"true" 

/> 
</TableRow> 
<TableRow> 

<TextView /> 

<CheckBox android:id="@+id/chkRememberPassword" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="Remember Password" 
/> 

</TableRow> 
<TableRow> 

«Button 
android:id="@+id/buttonSignIn" 
android:text="Log In" /> 

</TableRow> 
</TableLayout> 


图 3-7 展 示 了 以 上 代码 在 Android 模 拟 器 上 呈现 的 效果 ，。 
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可 注意 到 ， 在 上 述 例子 中 ，TableLayout 中 有 4 行 2 列 。 和 直接 位 于 Password TextView 之 下 的 单 
Ju l8 H«TextView/»^9 762838726. Ul XH. Remember Password 复 选 框 将 显示 在 Password 
TextView 之 下 ， 如 图 3-8 中 所 示 。 
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图 3-8 
3.1.5 ”RelativeLayout 


RelativeLayout 可 用 于 指 定子 视图 相对 于 彼此 之 同 是 如 何 定位 的 。 考 虑 下 列 main.xml 文 件 的 
"T 


<? xml version-"1.0" encoding-"utf-8"? > 

«RelativeLayout 
android:id-"8Q-c-id/RLayout" 
android:layout width-"fill parent" 


u[ikm d$). &E—^ "WC A RelativeLayoutH HJA 


如 下 所 
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android:layout height-"fill parent" 
xmlns:android-"http://schemas.android.com/apk/res/android" 
> 
«TextView 
android:id-"(cid/lblComments" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Comments" 
android:layout alignParentTop-"true" 
android:layout alignParentLeft-"true" 
/» 
«EditText 
android:id-"(id/txtComments" 
android:layout width-"fill parent" 
android:layout height-"170px" 
android:textSize-"18sp" 
android:layout alignLeft-'Q-id/lblComments" 
android:layout below-"(*id/lblComments" 
android:layout centerHorizontal-"true" 
/» 
«Button 
android:id-"(8-id/btnSave" 
android:layout width-"125px" 
android:layout height-"wrap content" 
android:text-"Save" 
android:layout below-"(-id/txtComments" 
android:layout alignRight-"(trid/txtComments" 
/> 
<Button 
android:id="@+id/btnCancel" 
android:layout width="124px" 
android:layout height-"wrap content" 
android:text-"Cancel" 
android:layout below-"(id/txtComments" 
android:layout alignLeft-"'Q-id/txtComments" 
/> 


</RelativeLayout> 


图 部 有 使 它 与 其 他 视图 对 齐 的 属性 。 这 些 属性 


不 : 
layout alignParentTop 
layout alignParentLeft 
layout alignLeft 
layout alignRight 
layout below 
layout centerHorizontal 


—^r sTERHEESUHBISLETRSID. Bir FTXMLHI P F i eE BEA 40 E 3-9 T7 « 


81 


82 


Android 编 程 入 门 经 典 


& 5554; Àndroid 2.3 Emulator 


comments 


Cancel 


hi3 4j [e]z s |o Jo. 
a lw le fr | [v ju 1 |o fe 
a |s |o fF efn fy ki |% 
Sz x fc lv le In | |. je 
wel = hL 


图 3-9 


3.1.6 FrameLayout 


FrameLayout;e — PE P E. n] VA FIO os RATLESL B EISE S SAIS FrameLayout'P HA 
图 常常 销 定 在 布局 的 左上 方 。 考 虑 main.xml 文 件 中 的 下 列 内 容 : 


«? xml version-"1.0" encoding-"utf-8"? > 

«RelativeLayout 
android:id-"8-c-id/RLayout" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


xmlns:android-"http://schemas.android.com/apk/res/android" 


> 

«TextView 
android:id="@+id/lblComments" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text-"This is my lovely dog, Ookii" 
android:layout alignParentTop-"true" 
android:layout alignParentLeft-"true" 
/> 

«FrameLayout 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignLeft-"Q-cid/lblComments" 
android:layout below-"Q-cid/lblComments" 
android:layout centerHorizontal-"true" 
> 
«ImageView 
android:src = "8drawable/ookii" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
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/? 
«/FrameLayout» 
«/RelativeLayout» 


这 里 ，RelativeLayout 中 有 一 个 FrameLayout。 在 该 FrameLayout 中 网 入 了 一 个 ImageView。 朋 
户 界 面 如 图 3-10 所 示 。 
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图 3-10 


P 注意 : 这 个 例子 假设 res/drawable-mdpi 文 件 夹 下 有 一 个 名 为 ookii.png 的 
图 像 。 


如 果 在 FrameLayout 中 添加 男 一 个 视图 (如 Button 视 图 )， 这 个 视图 将 窗 新 先前 的 视图 (如 
图 3-11 所 示 ): 
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<? xml version-"1.0" encoding-"utf-8"? > 
«RelativeLayout 
android:id-"Q-cid/RLayout" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
xmlns:android-"http://schemas.android.com/apk/res/android" 
> 
«TextView 
android:id-"Q-cid/lblComments" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"This is my lovely dog, Ookii" 
android:layout alignParentTop-"true" 
android:layout alignParentLeft-"true" 
/> 
«FrameLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignLeft-"8cid/lblComments" 
android:layout below-"Q-cid/lblComments" 
android:layout centerHorizontal-"true" 
> 
«ImageView 
android:src = "8drawable/ookii" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
f> 
<Button 
android:layout width="124dp" 


android:layout height="wrap content" 


android:text="Print Picture" 
f> 
«/FrameLayout» 
«/RelativeLayout» 


注意 : 虽然 可 以 在 FrameLayout 中 添加 多 个 视图 ， 但 每 一 个 视图 都 堆 滞 在 
前 一 个 上 面 。 这 在 想 将 一 系列 图 像 变 成 动画 ， 使 得 每 次 只 有 一 个 视图 可 见 的 情 
况 下 很 有 用 。 


3.1.7 ScrollView 


ScrollView 是 一 种 特殊 类 型 的 FrameLayout， 因 为 它 可 以 使 用 户 深 动 显示 一 个 占据 的 空间 大 
于 物理 显示 的 视图 列表 。ScrollView 只 能 包含 一 个 子 视图 或 视图 组 ， 通 常 是 LinearLayout。 


注意 : 不 要 将 ScrollView 和 ListView( 第 4 章 将 讨论 ) 一 起 使 用 。ListView 用 来 


显示 一 个 相关 信息 的 列表 并 针对 大 列表 的 处 理 进 行 了 优化 。 
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下 面 的 main.xml 的 内 容 显 示 了 一 个 包含 LinearLayout 的 ScrollView， 而 LinearLayout 又 包含 了 


一 些 Button 和 EditText 视 图 : 


<? xml version="1.0" encoding-"utf-8"? > 


«ScrollView 


android:layout width-"fill parent" 


android:layout height-"fill parent" 


xmlns:android-"http://schemas.android.com/apk/res/android" 


~ 


«LinearLayout 


android:layout width-"fill parent" 


android:layout height-"wrap content" 


android:orientation-"vertical" 


> 
«Button 


android: 


android 


android: 


android: 


/» 


«Button 


android: 
android: 
android: 


android: 


/> 


«Button 


android: 
android: 
android: 


android: 


/> 
«EditText 


android: 
android: 


android: 


/? 


«Button 


android: 
android: 
android: 


android: 


/> 


«Button 


android: 
android: 
android: 


android: 


/> 
</LinearLayout> 
</ScrollView> 


id=" @+id/button1" 


:layout width="fill parent" 


layout height="wrap content" 
text="Button 1" 


id="@+id/button2" 

layout width="fill parent" 
layout height="wrap content" 
text="Button 2" 


id="@+id/button3" 

layout width="fill parent" 
layout height-"wrap content" 
text-"Button 3" 


id="@+id/txt" 
layout width="fill parent" 
layout height-"300px" 


id=" @+id/button4" 

layout width-"fill parent" 
layout height-"wrap content" 
Ltext-"Button 4" 


id-"Qrid/buttonb5" 

layout width-"fill parent" 
layout height-"wrap content" 
text-"Button 5" 
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图 3-12 展 示 了 ScrollView 可 以 使 用 户 癌 上 拖 动 屏 幕 以 显示 位 于 屏幕 展 部 的 视图 。 


&  5554:Ándraid 2:3 Emulator 8 Android Z.3 Emulatar Bal Lo 


| 


L 
bme ren 


3-12 


3.2 ”适应 显示 方 回 


现代 智能 手机 的 主要 特征 之 一 是 它们 切换 屏幕 方 同 的 能 力 ，Android 也 不 例外 。Android 支 持 
两 种 屏幕 方 同 : 纵 同 和 横 同 。 默 认 情 况 下 ， 当 改变 Android 设 备 的 显示 方 同时 ， 当 前 显示 的 活动 
将 自动 在 新 方 同 上 重 绘 其 内 容 。 这 是 因为 当 显 示 方 问 上 发 生 改 变 时 ， 都 会 触发 活动 的 onCreate() 
事件 。 


注意 : 当 改 变 Android 设 备 的 方向 时 ， 当 前 活动 实际 上 是 先 被 销毁 ， 然 后 
再 重新 创建 。 


然而 ， 当 重 绘 时 ， 视 图 可 能 会 按照 其 原始 位 置 绘制 (这 取决 于 所 选择 的 布局 )。 图 3-13 展 示 了 
之 前 提 到 的 一 个 例子 ， 分 别 以 纵 问 和 横 回 模式 进行 显示 。 


momma © © © O 
U [I | 

so le le ERO 6b 
| DraraRRCRT GNRA vay ~ 
L- — .Lrrrr 


3-13 
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在 横向 模式 下 可 以 看 到 ， 屏 幕 右 侧 有 大 量 的 空余 空间 可 以 使 用 。 而 且 ， 当 屏幕 方向 被 设置 
JM bs nor. FERT BESSER IT LP BESSER AE ER o 
通常 ， 可 以 使 用 如 下 两 种 技术 来 处 理 屏幕 方向 的 变化 : 
e 销 定 一 一 将 视图 锚 定 到 屏幕 的 四 条 边 是 最 容易 的 方法 。 当 屏 芥 方 回 改变 时 ， 视 图 可 以 整齐 
地 锚 定 于 屏幕 边缘 。 


e 调整 大 小 和 重新 定位 


尽管 销 定 和 居中 显示 的 技术 简单 ， 可 以 确保 视图 能 处 理 屏 姑 方 回 


的 变化 ， 但 最 佳 的 技术 还 是 根据 当前 屏 有 验方 问 重新 调整 每 一 个 视图 的 大 小 。 


3.2.1 WEE 


使 用 RelativeLayout 可 以 很 容易 实现 锁定 。 考 虑 下 列 main.xml 文 件 ， 其 中 包含 了 移入 在 
<RelativeLayout> 元 素 中 的 5 个 Button 视 图 : 


<? xml version-z"1.0" encoding="utf-8"? > 


<RelativeLayout 


android:layout width-"fill parent" 


android:layout height-"fill parent" 


xmlns:android-"http://schemas.android.com/apk/res/android" 


> 


<Button 


android:id="@+id/button1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Top Left Button" 
android:layout alignParentLeft-"true" 
android:layout alignParentTop-"true" 
/> 


«Button 


android:id-"(4id/button2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Top Right Button" 
android:layout alignParentTop-'true" 
android:layout alignParentRight-"true" 
/? 


«Button 


android:id-"(wid/button3" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Bottom Left Button" 
android:layout alignParentLeft-"true" 
android:layout alignParentBottom-'"true" 
/> 


«Button 


android:id-"Q-cid/button4" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"Bottom Right Button" 
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android:layout alignParentRight-"'"true'" 
android:layout alignParentBottom-"true" 
re 

«Button 
android:id-"(( -id/buttonb5" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Middle Button" 
android:layout centerVertical-"true" 
android:layout centerHorizontal-"'true" 
/ > 


«/RelativeLayout» 


注意 不 同 Button 视 图 中 所 具有 的 以 下 属性 : 


€ layout alignParentLeft 一 一 将 视图 与 其 父 视 图 的 左 侧 对 齐 

€ ”layout_alienParentRight 一 一 将 视图 与 其 父 视图 的 右 侧 对 齐 
€ layout_alignParentTop 一 一 将 视图 与 其 父 视图 的 上 部 对 齐 

€ layout alignParentBottom 一 一 将 视图 与 其 父 视图 的 底部 对 齐 
€ Jlayout center Vertical —— {EPL A] TE HS 4 s] F aie E ar H 

€ layout_centerHorizontal 一 一 使 视图 在 其 父 视图 中 水 平 居 中 


图 3-14 展 示 了 以 纵 同 模式 观察 到 的 活动 的 效果 。 


5dAndroid 2.3 Emulator 


Top Left Button Top Right Button c eo eo eo 


o (o 


© 090 


Middle Button 


Bottom Left Button Bottom Right Button 
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当 屏 幕 方向 改变 为 横向 模式 时 ，4 个 按钮 对 齐 到 屏幕 的 四 边 。 中 间 的 按钮 在 屏幕 中 央 显 示 ， 
宽度 完全 拉 伸 到 整个 屏幕 (如 图 3-15 所 示 )。 
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8 5554 ndroid 2.3 Emulator 
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图 3-15 


3.2.2 ”调整 大 小 和 重新 定位 
除了 将 视图 锚 定 到 屏幕 的 四 边 之 外 ， 基 于 屏幕 方向 定制 用 户 界面 的 E» assets 


更 简单 的 方法 是 为 每 个 方向 上 的 用 户 界面 创建 一 个 包含 XML 文件 的 单 | os em nti ts 
独 的 res/layout 文 件 夹 。 为 了 支持 横向 模式 ， 可 以 在 res 文 件 夹 下 创建 一 i 
个 新 文件 夹 ， 并 命名 为 layout-land( 表 示 横 向 )。 图 3-16 显 示 了 这 样 的 含有 od 
main xml 文 件 的 新 文件 来。 ‘ied 
基本 上 ， 包 含 在 layout 文 件 夹 下 的 main.xml 文 件 为 活动 定义 了 纵 问 IM 
模式 的 用 户 界 面 ， 而 在 layout-land 文 件 夹 下 的 main.xml 文 件 定 义 了 横 问 pe 


模式 的 用 r Jr IE o [&| 3-16 
layout 文 件 夹 下 的 main.xml 文 件 的 内 容 如 下 所 示 : 


<? xml version-z"1.0" encoding-"utf-8"? > 
«RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


xmlns:android-"http://schemas.android.com/apk/res/android" 


«Button 
android:id-"8cid/buttonl" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Top Left Button" 
android:layout alignParentLeft-"true" 
android:layout alignParentTop-"true" 
/> 

<Button 


android:id="@+id/button2" 
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android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Top Right Button" 
android:layout alignParentTop-"true" 
android:layout alignParentRight-"true" 
/> 

<Button 
android:id="@+id/button3" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Bottom Left Button" 
android:layout alignParentLeft-"true" 
android:layout alignParentBottom-"true" 
/? 

«Button 
android:id-"Q(-id/button4" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Bottom Right Button" 
android:layout alignParentRight-"true" 
android:layout alignParentBottom-"true" 
/> 

<Button 
android:id="@+id/button5" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Middle Button" 
android:layout centerVertical-"true" 
android:layout centerHorizontal-"true" 
/? 


«/RelativeLayout» 


下 面 显 示 了 layout-land 文 件 夹 下 的 main.xml 文 件 的 内 容 ( 粗 体 显 示 的 语句 是 以 横 癌 模式 显示 
的 额外 视图 ): 


<? xml version-"1.0" encoding-"utf-8"? > 
«RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


xmlns:android-"http://schemas.android.com/apk/res/android" 


> 

<Button 
android:id="@+id/button1" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Top Left Button" 
android:layout alignParentLeft="true" 
android:layout alignParentTop="true" 
[> 

«Button 
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android:id="@+id/button2" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Top Right Button" 
android:layout alignParentTop-"true" 
android:layout alignParentRight-"true" 
/? 

«Button 
android:id-"(*id/button3" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Bottom Left Button" 
android:layout alignParentLeft-"true" 
android:layout alignParentBottom-"true" 
J3 

<Button 
android:id="@+id/button4" 
android:layout width="wrap content" 
android:layout height-"wrap content" 
android:text-"Bottom Right Button" 
android:layout alignParentRight-"true" 
android:layout alignParentBottom-"true" 
/> 

<Button 
android:id="@+id/button5" 
android:layout width="fill parent" 
android:layout height-"wrap content" 
android:text-"Middle Button" 
android:layout centerVertical-"true" 
android:layout centerHorizontal-"true" 
/? 

«Button 


android: 
android: 
android: 
android: 
android: 
android: 
android: 


/> 


«Button 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


/> 


id="@+id/button6" 

layout width-"180px" 

layout height-"wrap content" 
text-"Top Middle Button" 
layout centerVertical-"true" 
layout centerHorizontal-"true" 


layout alignParentTop-"true" 


id="@+id/button7" 

layout width-"180px" 

layout height-"wrap content" 
text-"Bottom Middle Button" 
layout centerVertical-"true" 
layout centerHorizontal-"true" 


layout alignParentBottom-"true" 


«/RelativeLayout» 
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当 活 动 以 纵 同 模式 加 载 时 ， 将 显示 5 个 按钮 ， 如 图 3-17 所 示 。 
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当 活 动 以 模 同 模式 加 载 时 ， 将 出 现 7 个 按钮 (如 图 3-18 所 示 )， 这 证 明 当 设备 处 于 不 同方 同 
时 ， 将 加 载 不 同 的 XML 文 件 。 
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图 3-18 
使 用 这 种 方法 ， 当 设备 方 回 改变 时 ，Android 将 根据 当前 屏幕 方 回 为 活动 目 动 加 载 相应 的 
XML 文件 。 


3.3 管理 屏幕 方向 的 变化 


既然 已 经 了 解 了 如 何 实 现 两 种 技术 以 便 适 应 屏 和 项 方 回 的 变化 ， 那 么 让 我 们 探究 一 下 当 设 备 改 
变 廊 同时 活动 的 状态 会 发 生 什么 情况 。 下 面 的 “ 试 一 试 ” 展 示 了 当 设 备 改变 廊 同 时 活动 的 行为 。 
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了 解 方向 改变 时 活动 的 行为 
Orientations.zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 使 用 Eclipse， 创 建 一 个 名 为 Orientations 的 新 项 目 。 
(2) 在 main.xml 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


<? xml version-"1.0" encoding-"utf-8"? > 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
«EditText 
android:id-"(trid/txtFieldl" 
android:layout width-"ftill parent" 
android:layout height-"wrap content" /> 
<EditText 
android:layout width="fill parent" 
android:layout height-"wrap content" /> 
</LinearLayout> 


(3) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Orientations; 


import android.app.Activity; 


import android.os.Bundle; 
import android.util.Log; 


public class MainActivity extends Activity I{ 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
Log.d("Statelnfo", "onCreate"); 


QGOverride 
public void onStart() ( 
Log.d("StatelInfo", "onStart"); 


super.onStart(); 


QOverride 
public void onResume() { 
Log.d("StateInfo", "onResume"); 


super.onResume (); 
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QOverride 
public void onPause() I 
Log.d("StateInfo", "onPause"); 


super.onPause(); 


Override 

public void onStop() { 
Log.d("StateInfo", "onStop"); 
super.onStop(); 


üOverride 
public void onDestroy() ( 
Log.d("StateInfo", "onDestroy"); 


super.onDestroy(); 


QOverride 

public void onRestart() ( 
Log.d("StateInfo", "onRestart"); 
super.onRestart(); 


(4) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 
(5) 在 两 个 EditText 视 图 中 输入 一 些 文本 (如 图 3-19 所 示 )。 
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图 3-19 


#3% Android AARM 


(6) 按 Ctrl+F11 组 合 键 改 变 Android 模 拟 器 的 显示 方向 。 图 3-20 显 示 了 横 问 模式 下 的 模拟 器 效 
果 。 注 意 ， 第 1 个 EditText 视 图 中 的 文本 仍旧 可 见 ， 而 第 2 个 EditText 视 图 为 空 
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图 3-20 


(7) 观察 LogCat 窗 口中 的 输出 (需要 在 Eclipse 中 切换 到 Debug 透 视图 )， 应 该 看 到 关 似 如 下 所 


示 内 容 : 


01-05 13: 
01-05 13: 
01-05 13: 


01-05 13: 
01-05 13: 
01-05 13: 
01-05 13: 
01-05 13: 
01-05 13: 


32:30 
32:30 
32:30 


EE 
392120; 


35:20 
35:20 
35:20 
35:20 


.266: DEBUG/StateInfo(5477): onCreate 
.296: DEBUG/StateInfo(5477): onStart 
.296: DEBUG/StateInfo(5477): onResume 


106: DEBUG/StateInfo(5477): onPause 
106: DEBUG/StateInfo(5477): onStop 
.106: DEBUG/StateInfo(5477): onDestroy 
.246: DEBUG/StateInfo(5477): onCreate 
.256: DEBUG/StateInfo(5477): onStart 
.256: DEBUG/StateInfo(5477): onResume 


从 LogCat 窗 口中 的 输出 内 容 可 以 明显 看 出 ， 当 设 备 改变 方 同 时 ， 活 动 先 被 销毁 : 


01-05 13: 
01-05 13: 
01-05 13: 


35:20. 


35:20 


35:20. 


106: DEBUG/StateInfo(5477): onPause 
.106: DEBUG/StateInfo(5477): onStop 
106: DEBUG/StateInfo(5477): onDestroy 


01-05 13:35:20.246: DEBUG/StateInfo(5477): onCreate 
01-05 13:35:20.256: DEBUG/StateInfo(5477): onStart 
01-05 13:35:20.256: DEBUG/StateInfo(5477): onResume 
了 解 这 一 行为 是 重要 的 ， 因 为 需要 确保 米 取 必要 的 措施 来 保持 方 同 改 变 之 前 活动 的 状态 。 


go 
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例如 ， 在 活动 中 有 包含 一 些 计 算 所 需 的 值 的 变量 。 对 于 任意 活动 ， 应 该 在 onPause() 事 件 中 保存 
任何 您 需要 保存 的 状态 ， 这 一 事件 在 每 次 活动 改变 方 同 时 触发 。3.3.1 节 讲述 保存 状态 信息 的 不 
同方 法 。 

另 一 个 赶 要 理解 的 重要 行为 是 当 包 含 视图 的 活动 被 销毁 时 ， 只 有 那些 在 这 个 活动 中 被 命名 
的 视图 (通过 android:id 属 性 ) 才 能 保持 它们 的 状态 。 例 如 ， 在 向 EditText 视 图 中 输入 一 些 文本 同 
时 ， 用 户 可 能 会 改变 显示 方向 。 出 现 这 种 情况 时 ，EditText 视 图 中 的 任何 文本 将 被 保持 并 在 活动 
重新 创建 时 自动 恢复 。 相 反 ， 如 果 没 有 使 用 android:id 属 性 命名 EditText 视 图 ， 活 动 将 无 法 保持 视 
图 中 当前 所 含 文本 。 


3.3.1 配置 改变 时 保持 状态 信息 


到 目前 为 止 ， 您 已 经 学 习 了 屏 禹 方 回 改 变 时 会 销 开 和 重建 一 个 活动 。 记 住 ， 当 重建 一 个 活动 
时 ， 活 动 的 当前 状态 可 能 会 去 失 。 当 终止 一 个 活动 时 ， 将 触发 以 下 两 个 事件 中 的 一 个 或 多 个 : 
€ onPause() 当 一 个 活动 被 终止 或 转 入 后 台 时 都 会 触发 这 一 事件 。 
€ onSavelnstanceState() 当 一 个 活动 将 要 被 终止 或 转 入 后 台 时 ， 也 会 触发 这 一 事件 (正如 
onPause(0) 事 件 一 样 )。 然 而 ， 与 onPause0 事 件 不 同 的 是 ， 当 一 个 活动 从 栈 中 邑 载 时 (例如 用 户 
按 下 了 Back 按 钮 ) 不 会 触发 onSaveInstanceState(0) 事 件 ， 这 是 因为 后 面 无 须 恢复 其 状态 。 
舍 而 言 之 ， 要 保持 一 个 活动 的 状态 ， 可 以 实现 onPause0 事 件 ， 然 后 使 用 目 己 的 方法 来 保存 
活动 状态 ， 如 利用 数据 库 、 内 部 或 外 部 的 文件 存储 右 等 。 
如 果 只 是 想 保 存活 动 状 态 用 来 在 以 后 活动 重建 时 (例如 当 设 备 改 变 方向 时 ) 进 行 恢复 ， 那 么 
更 简单 的 方法 是 实现 onSavelInstanceState() 方 法 。 这 个 方法 提供 了 Bundle 对 象 作为 一 个 参数 ， 可 
以 用 它 保 存活 动 的 状态 。 以 下 代码 展 示 了 在 onSaveInstanceState 事 件 中 可 以 将 字符 冲 ID 保 存 到 
Bundle 对 象 中 : 
QOverride 
public void onSavelnstanceState(Bundle outState) [ 
/ /一 -保存 您 想 保持 的 任何 状态 -一 - 
outState.putString("TD", "1234567890"); 


super.onSaveInstanceState(outState); 


} 


当 重 建 一 个 活动 时 ， 首 先 触 发 onCreate0 事 件 ， 随 后 是 onRestoreInstanceState() 事 件 。 此 事件 
可 以 使 您 检索 先前 在 onSaveInstanceState 事 件 中 通过 其 参数 Bundle 对 象 保 存 的 状态 : 
QOverride 


public void onRestoreInstanceState(Bundle savedInstanceState) { 


super.onRestoreInstanceState (savedInstanceState); 
//--- 检 索 先前 保留 的 信息 --- 


String ID = savedInstancestate.getstring("ID");} 


尽管 可 以 使 用 onSavelInstanceState() 事 件 来 保存 状态 信息 ， 但 要 注意 只 能 通过 一 个 Bundle 对 
象 保 存 状态 信息 的 局 限 性 。 如 果 需 要 保存 更 复 森 的 数据 结构 ， 这 就 不 是 一 个 合适 的 解决 方法 。 

男 一 个 可 以 使 用 的 事件 处 理 程序 是 onRetainNonConfieurationInstance() 事 件 。 当 一 个 活动 由 于 
配置 改变 将 要 被 销毁 时 会 触发 这 一 事件 。 可 以 通过 在 该 事件 中 返回 来 保存 当前 的 数据 ， 如 下 所 示 : 
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QOverride 
public Object onRetainNonConfigurationInstance() { 
//--- 在 此 处 保存 任何 您 想 要 保存 的 数据 ， 它 接受 object 类 型 --- 


return("Some text to preserve"); 


注意 : 当 屏 幕 方向 改变 时 ， 这 一 变化 是 所 谓 配置 改变 的 一 部 分 。 配 置 改变 


将 销毁 您 的 当前 活动 。 


注意 ， 此 事件 返回 一 个 Object 类 型 ， 它 几乎 允许 返回 任何 数据 类 型 。 要 提取 保存 的 数据 ， 可 
以 使 用 getLastNonConfigurationInstance() 方 法 在 onCreate0 事 件 中 进行 提取 ， 如 下 所 示 : 


QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
Log.d("Stateinfo", "onCreate"); 
String str = (String) getLastNonConfigurationInstance (); 


3.3.2 ”检测 方向 改变 


有 时 需要 在 运行 时 知道 设备 的 当前 方 同 。 要 确定 这 一 点 ， 可 以 使 用 WindowManger 类 。 以 下 
代 人 码 片 段 演 示 了 如 何以 编程 方式 来 检测 活动 的 当前 方 同 : 


import android.util.Log; 
import android.view.Display; 
import android.view.WindowManager; 
Pers 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//--- 获 取 当 前 显示 信息 --- 
WindowManager wm = getWindowManager(); 
Display d = wm.getDefaultDisplay(); 


if (d.getWidth() » d.getHeight()) 


{ 

//--- 横 向 模式 --- 

Log.d("Orientation", "Landscape mode"); 
} 
else 
{ 

//--- 纵 向 模式 --- 

Log.d("Orientation", "Portrait mode"); 
} 


ur 


Android 编 程 入 门 经 暴 


getDefaultDisplay(0) 方 法 返回 一 个 表示 设备 屏幕 的 Display 对 象 。 然 后 ， 您 可 以 获得 其 宽度 和 
mE. BET HEW UO A BUT BEES [5] « 


3.3.3 ”控制 活动 的 方向 
有 时 ， 您 也 许 想 要 保证 应 用 程序 只 在 一 个 特定 的 方向 上 显示 。 例 如 ， 您 可 能 正在 编写 一 个 


d 4* HJ 
E 


只 能 以 横 问 模式 呈现 的 游戏 。 在 这 种 情况 下 ， 可 以 使 用 Activity 类 的 setRequestOrientation() 方 法 
以 编程 方式 强制 改变 显示 方 问 : 


import android.content.pm.ActivityInfo; 


public class MainActivity extends Activity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
//--- 改 为 横向 模式 --- 
setRequestedOrientation(ActivityInfo.SCREEN ORIENTATION LANDSCAPE); 
} 


要 改 为 纵向 模式 ， 可 使 用 ActivityInfo.SCREEN_ORIENTATION_PORTRAIT 常 量 : 
setRequestedOrientation(ActivityInfo.SCREEN ORIENTATION PORTRAIT); 


Uk T f&HjsetRequestOrientation)7; 7X, nJ LÆ AndroidManifest.xml X: {FF 'J«activity»7U0 2s 
上 使 用 android:screenOrientation 属 性 ， 来 将 活动 限制 在 一 个 特定 方向 上 ， 如 下 所 示 : 
<? xml version-z"1.0" encoding-"utf-8"? > 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Orientations" 
android:versionCode-"]" 
android:versionName-"1.0"» 
«application android:icon-"8drawable/icon" android:label-"8string/app name"> 
«activity android:name-".MainActivity" 
android:label-"G8string/app name" 
android:screenOrientation-"landscape" > 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"9" /> 
«/manifest» 


EXSBS B] E 80 PR il £e — A1 Rr E92; I] Ea Abe de), JF HBUIETRAUHEE Ex. tL 
当 设备 方 问 改变 时 ， 活 动 不 会 被 销毁 并 且 也 不 会 再 次 触发 onCreate(0 事 件 。 

以 下 是 在 android:screenOrientation 属 性 中 可 以 指定 的 两 个 值 : 

€ Dortrait 一 一 纵 回 模式 

AE T AE VE 


0 sensor 
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3.4 ”以 编程 方式 创建 用 户 界 面 


到 目前 为 止 ， 您 在 本 章 中 所 看 到 的 所 有 用 户 界 面部 古 使 用 XML 创 建 的 。 如 前 所 述 ， 除 了 使 
用 XML， 还 可 以 使 用 代码 创建 用 户 界 面 。 如 案 用 户 界 面 需要 在 运行 时 动态 生成 ， 这 个 方法 束 很 
有 有 用。 例如， 设想 您 正在 构建 一 个 电影 村 预 订 系统 ， 您 的 应 用 程序 将 使 用 按钮 显示 每 场 电影 的 
座位 。 这 种 情况 下 ， 束 需要 根据 用 户 选 择 的 电影 来 动态 生成 用 户 界 面 。 

下 面 的 “ 试 一 试 ”演示 了 在 活动 中 动态 构建 用 户 界 面 所 需 的 代 但 。 


通过 代码 创建 用 户 界面 
UICode.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 使 用 Eclipse， 创 建 一 个 名 为 UICode 的 新 Android 项 目 。 
(2) 在 MainActivity.java 文 件 中 ， 添 加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.UICode; 


import android.app.Activity; 


import android.os.Bundle; 


import android.view.ViewGroup.LayoutParams; 
import android.widget.Button; 

import android.widget.LinearLayout; 

import android.widget.TextView; 


public class MainActivity extends Activity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOVveTrTide 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


//setContentView(R.layout.main); 


//--- 视 图 的 参数 --- 
LayoutParams params = 
new LinearLayout.LayoutParams ( 
LayoutParams.FILL PARENT, 
LayoutParams.WRAP CONTENT); 


//--- 创 建 一 个 布局 --- 


LinearLayout layout = new LinearLayout(this); 
layout.setOrientation(LinearLayout.VERTICAL); 


//--- 创 建 一 个 文本 视图 --- 
TextView tv = new TextView(this); 
tv.setText("This is a TextView"); 


tv.setLayoutParams (params); 


//--- 创 建 一 个 按钮 --- 
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Button btn - new Button(this); 
btn.setText("This is a Button"); 


btn.setLayoutParams (params); 


//--- 添 加 文本 视图 --- 
layout.addView(tv); 


//--- 添 加 按钮 --- 
layout.addView (btn); 


//--- 为 布局 创建 一 个 布局 参数 --- 
LinearLayout.LayoutParams layoutParam = 
new LinearLayout.LayoutParams ( 
LayoutParams.FILL PARENT, 
LayoutParams.WRAP CONTENT ); 


this.addContentView(layout, layoutParam); 


) 
(3) 按 Fl11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 图 3-21 显 示 活 动 被 创建 了 。 


E 5554Android_2.3_Emulator 


IcCode 
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图 3-21 


示例 说 明 


本 例 中 ， 首 先 注释 掉 setContentView0 语 句 ， 这 样 就 不 从 main.xml 文 件 加载 用 户 界面 。 
然后 ， 创 建 一 个 LayoutParams 对 象 来 指定 可 以 被 别 的 视图 ( 接 下 来 将 创建 ) 使 用 的 布局 参数 : 


//--- 视 图 的 参数 --- 
LayoutParams params = 
new LinearLayout.LayoutParams( 
LayoutParams.FILL PARENT, 
LayoutParams.WRAP CONTENT); 
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还 创建 一 个 LinearLayout 对 象 来 包含 活动 中 所 有 的 视图 : 
//--- 创 建 一 个 布局 --- 


LinearLayout layout = new LinearLayout (this); 
layout.setOrientation(LinearLayout.VERTICAL); 


一 步 ， 人 创建 一 个 TextView 视 图 和 一 个 Button 视 图 : 
/ /创建 一 个 文本 视图 -一 - 


TextView tv = new TextView(this); 
tv.setText("This is a TextView"); 


tv.setLayoutParams (params); 


//--- 创 建 一 个 按钮 --- 
Button btn = new Button(this); 
btn.setText("This is a Button"); 


btn.setLayoutParams (params); 


然后 将 它们 添加 到 LinearLayout 对 象 中 : 


/7/--- 添 加 文本 视图 ---- 
layout.addView (tv); 


//--- 添 加 按钮 --- 
layout.addView (btn); 

另外， 创建 一 个 被 LinearLayout 对 象 使 用 的 LayoutParams 对 你: 
//--- 为 布局 创建 一 个 布局 参数 --- 


LinearLayout.LayoutParams layoutParam = 
new LinearLayout.LayoutParams( 
LayoutParams.FILL PARENT, 
LayoutParams.WRAP CONTENT ); 


最 后 ， 将 LinearLayout 对 象 添 加 到 活动 中 : 


this.addContentView(layout, layoutParam); 


我 们 可 以 看 出 ， 使 用 代码 创建 用 户 界 面 是 一 个 非 芝 费力 的 工作 。 因 此 ， 只 有 在 必要 时 才 使 


用 代码 来 动态 生成 用 户 界 面 。 


3.5 pnr FP S AT 


用 户 和 用 户 界 面 在 两 个 层面 上 进行 交互 : 活动 层面 和 视图 层面 。 在 活动 层面 ，Activity 类 暴 


露 了 可 以 被 重 写 的 方法 。 一 些 常见 的 可 以 在 活 Arist estia 
€ onKeyDown 一 一 当 一 个 键 被 按 下 并 且 没 有 被 活动 中 的 任何 视图 处 理 时 调用 
€ onKEeyUp 一 一 当 一 个 键 被 释放 并 且 没 有 被 活动 中 的 任何 视图 处 理 时 调用 
€ onMenultemSelected 当 用 户 选 择 了 面板 的 菜单 时 调用 ( 见 第 5 章 ) 
€ onMenuOpened 一 一 当 用 户 打 开 了 面板 的 沫 单 时 调用 ( 见 第 5$ 章 ) 


Android 用 户 界面 
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3.5.1 重 与 活动 中 定义 的 方法 


为 了 理解 活动 是 如 何 与 用 户 交 互 的， 让 我 们 从 重 写 活动 的 基 关 中 定义 的 一 些 方法 说 起 ， 看 
一 看 当 用 户 和 活动 交互 时 ， 这 些 方法 是 如 何 被 处 理 的 。 


重 写 活动 的 方法 
UIActivity.zip 代 , 码 文件 可 以 在 Wroxcom 上 下 载 


(1) 使 用 Eclipse， 创 建 一 个 新 的 Android 项 目 ， 并 命名 为 UIActivity。 
(2) 在 main.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


<? xml version-"1.0" encoding-"utf-8"? > 
«LinearLayout 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" 
xmlns:android-"http://schemas.android.com/apk/res/android" 
> 
«TextView 
android:layout width-"214dp" 
android:layout height-"wrap content" 
android:text-"Your Name" 
/> 
<EditText 
android:id="@+id/txt1" 
android:layout width-"214dp" 
android:layout height-"wrap content" 
/> 
<Button 
android:id="@+id/btn1" 
android:layout width="106dp" 
android:layout height-"wrap content" 
android:text-"OK" 
/> 
«Button 
android:id-"(t-id/btn2" 
android:layout width-"106dp" 
android:layout height-"wrap content" 
android:text-"Cancel" 
/> 


</LinearLayout> 
(3) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.UIActivity; 


import android.app.Activity; 


import android.os.Bundle; 
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import android.view.KeyEvent; 
import android.widget.Toast; 


public class MainActivity extends Activity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


QOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) 
i 
switch (keyCode) 
{ 
case KeyEvent.KEYCODE DPAD CENTER: 
Toast.makeText(getBaseContext(), 
"Center was clicked", 
Toast.LENGTH LONG).show(); 
break; 
case KeyEvent.KEYCODE DPAD LEFT: 
Toast.makeText(getBaseContext(), 
"Left arrow was clicked", 
Toast.LENGTH LONG).show(); 
break; 
case KeyEvent.KEYCODE DPAD RIGHT: 
Toast.makeText(getBaseContext(), 
"Right arrow was clicked", 
Toast.LENGTH LONG) .show(); 
break; 
case KeyEvent.KEYCODE DPAD UP: 
Toast.makeText(getBaseContext(), 
"Up arrow was clicked", 
Toast.LENGTH LONG).show(); 


break; 
case KeyEvent.KEYCODE DPAD DOWN: 
Toast.makeText(getBaseContext(), 
"Down arrow was clicked", 
Toast.LENGTH LONG).show(); 
break; 
] 


return false; 
} 


(4) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 


(5) 当 活 动 加 载 后 ， 输 入 一 些 文本 ， 如 图 3-22 左 边 所 示 。 下 一 步 ， 单 击 方向 键盘 上 的 下 箭头 


键 。 观 察 屏 医 上 显示 的 消 恩 ， 如 图 3-22 石 边 黑色 区 域 所 示 。 
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图 3-22 
示例 说 明 
当 加 载 活动 时 ， 光 标 将 在 EditText 视 图 中 闪烁 ， 因 为 它 获得 了 焦点 。 
在 MainActivity 类 中 ， 按 如 下 所 示 重 写 Activity 基 类 的 onKeyDown(0) 方 法 : 
QOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) 
{ 
switch (keyCode) 
{ 
case Keybvent.KEYCODE DEAD CENTER: 
Fess 
break; 
case Keybvent.KEYCODE DPAD LEFT: 
[fs 
break; 
case Keybvent.KEYCODE DPAD RIGHT: 
E 
break; 
case KeyEvent.KEYCODE DEAD UP: 
ff ess 
break; 
case Keybvent.KEYCODE DPAD DOWN: 
ffo 
break; 
} 
return false; 
} 


在 Android 中 ， 当 您 按 下 设备 上 的 任意 一 个 键 时 ， 当 前 获得 焦点 的 视图 将 试图 处 理 生 成 的 事 
件 。 本 例 中 ， 当 EditText 获 得 焦点 并 且 您 按 下 了 一 个 键 时 ，EditText 视 图 将 处 理 这 一 事件 并 在 视 
图 中 将 您 刚刚 输入 的 字符 显示 出 来 。 然 而 ， 如 果 您 按 了 上 或 下 箭头 键 ，EditText 视 图 不 会 对 此 
作 处 理 ， 相 反 会 将 这 个 事件 传递 给 活动 。 在 这 种 情况 下 ， 将 调用 onKeyDown() 方 法 。 本 例 中 ， 
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上 ， 即 OK 按钮 。 Tip 
有 趣 的 是 ， 如 果 EditText 视 图 内 已 经 有 了 一 些 文本 ， 并 且 
光标 位 于 文本 末尾 (如 图 3-23 所 示 )， 那 么 单 击 左 入 关键 不 会 触发 
onKeyDown() 事 件 ， 而 只 是 将 光标 同 左 移动 一 个 字 件 。 这 是 由 于 
EditText 视 图 已 经 处 理 了 这 一 事件 。 如 果 按 下 的 是 右 篆 头 键 ， 将 调用 
onKeyDown() 方 法 (因为 现在 EditText 视 图 将 不 会 处 理 这 一 事件 )。 这 
同样 适用 于 光标 位 于 EditText 视 图 开始 的 情况 : 单 击 左 箭头 将 触发 
— riis Heidi pea i — 


显示 出 来 。 这 是 H oiii 本 身 tie T 单 击 事件 。 elie 
件 。 不 过 ， 如 果 此 时 没有 任何 视图 获得 焦点 的 话 (可 以 通过 单 击 屏 肛 背景 实现 )， 那 么 按 下 中 间 键 
将 显示 Center was clicked 消 息 ( 如 图 3-24 所 示 )。 


& 5554; Àndraid 2.3 Emulator 


E wl E 420 


Your Name 


Center was clicked | 


图 3-24 
注意 ，onKeyDown0 方 法 返回 一 个 boolean 类 型 的 结果 。 当 想 告 诉 系 统 您 已 经 处 理 完 此 事件 
并 且 系 统 不 要 再 作 进一步 的 处 理 时 ， 应 当 返 回 true。 人 例如， 考虑 下 列 当 每 一 个 键 匹 配 后 返回 true 
时 的 情况 : 
QOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) 
i 
switch (keyCode) 
{ 
case Keybvent.KEYCODE DPAD CENTER: 
Toast.makeText(getBaseContext(), 
"Center was clicked", 
Toast.LENGTH LONG).show(); 
return true; 
case KeyEvent.KbEYCODE DEAD LEFT: 
Toast.makeText(getBaseContext (), 


"Left arrow was clicked", 
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Toast.LENGTH LONG).show(); 
return true; 
case Keybvent.KEYCODE DEAD RIGHT: 
Toast.makeText(getBaseContext (), 
"Right arrow was clicked", 
Toast.LENGTH LONG).show(); 
return true; 
case KeyEvent.KEYCODE DEAD UP: 
Toast.makeText(getBaseContext (), 
"Up arrow was clicked", 
Toast.LENGTH LONG).show(); 
return true; 
case Keybvent.KEYCODE DPAD DOWN: 
Toast.makeText(getBaseContext (), 
"Down arrow was clicked", 
Toast.LENGTH LONG).show(); 
return true; 
} 


return false; 


如 果 测 试 一 下 ， 怠 会 发 现 现 在 不 能 使 用 盘 头 键 在 视图 之 间 导 航 。 


3.5.2 ”为 视图 注册 事件 


当 用 户 和 视图 交互 时 ， 视 图 可 以 触发 事件 。 例 如 ， 当 用 户 触 碰 一 个 Button 视 图 时 ， 您 需要 
啊 应 这 个 事件 以 便 能 够 采取 适当 的 动作 。 要 做 到 这 一 点 ， 壳 要 为 视图 显 式 地 注册 事件 。 

使 用 上 一 市 讨论 的 同一 个 例子 ， 我 们 知道 那个 活动 有 两 个 Button 视 图 ; 因此 ， 可 以 使 用 一 
个 匿名 类 注册 按钮 单 击 事 件 ， 如 下 所 示 : 


package net.learn2develop.UIActivity; 


import android.app.Activity; 
import android.os.Bundle; 
import android.view.KeyEvent; 
import android.view.View; 


import android.widget.Toast; 


import android.view.View.OnClickListener; 
import android.widget.Button; 


public class ee extends Activity 1 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 
//--- 两 个 按钮 被 连接 到 同一 个 事件 处 理 程序 --- 
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Button btnl = (Button)findViewById(R.id.btn1); 
btnl.setOnClickListener (btnListener); 


Button btn2 = (Button)findViewById (R.id.btn2); 
btn2.setOnClickListener (btnListener); 


//--- 创 建 一 个 匿名 类 作为 按钮 单 击 的 侦 听 器 --- 


private OnClickListener btnListener - new OnClickListener() 


{ 
public void onClick(View v) 


{ 
Toast.makeText(getBaseContext(), 
((Button) v).getText() 十 " was clicked", 
Toast.LENGTH LONG).show(); 
] 
); 
QOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) 
1 
switch (keyCode) 
{ 
Ff ess 
ffoes 
} 


return false; 


现在 ， 无 论 您 按 下 的 是 OK 按钮 还 是 Cancel 按 钮 ， 痢 会 显示 出 相应 的 消 因 (如 图 3-25 所 示 )， 
这 证 明 该 事件 被 正确 地 连接 起 来 了 。 


»  S554;Android 2.3 Emulator o| W 


Your Name 


| Okwaæadicked | 


&| 3-25 
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除了 为 事件 处 理 程序 定义 一 个 匿名 类 外 ， 还 可 以 定义 一 个 匿名 内 部 类 来 处 理事 件 。 下 面 的 
示例 显示 了 如 何 为 EditText 视 图 处 理 onFoucusChangeO 事 件 。 


import android.widget.EditText; 


public class MainActivity extends Activity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//--- 两 个 按钮 被 连接 到 同一 个 事件 处 理 程序 --- 
Button btnl = (Button)findViewById (R.id.btnl); 
btnl.setOnClickListener (btnListener); 


Button btn2 = (Button)findViewById (R.id.btn2); 
btn2.setOnClickListener (btnListener); 


EditText txtl = (EditText)findViewById(R.id.txtl); 


//--- 创 建 一 个 匿名 内 部 类 作为 获得 焦点 事件 的 侦 听 器 --- 


txtl.setOnFocusChangeListener (new View.OnFocusChangeListener() 


{ 
QOverride 
public void onFocusChange (View v, boolean hasFocus) { 
Toast.makeText(getBaseContext(), 
((EditText) v).getlId() + " has focus - " + hasFocus, 
Toast.LENGTH LONG).show(); 
] 
}); 


} 
当 EditText 视 图 收 到 焦点 时 ， 屏 医 上 将 输出 一 条 消息 ， 如 图 3-26 所 示 。 


B 5554 Android 2.3 Emulator 


 [uractivity 


Your Mame 


Cancel 


2131034113 has focus - true 
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3.6 ”本 章 小 结 


本 章 学 习 了 如 何在 Android 中 创建 用 户 界面 ， 还 学 习 了 可 以 用 来 在 Android 用 户 界 面 中 定位 视 
图 的 不 同 布局 。 由 于 Android 设 备 文 持 多 种 屏 攻 方 同 ， 所 以 需要 特别 注意 这 一 点 ， 以 确保 您 的 用 
户 界 面 能 够 适应 屏幕 方 问 的 改变 。 


1. dp 单位 和 px 单位 有 何不 同 ? 应 该 用 哪 一 个 来 指定 视图 的 尺寸 ? 
为 什么 不 建议 使 用 AbsoluteLayout? 
onPause() 事 件 和 onSavelnstanceState() 事 件 有 何 区 别 ? 
列举 3 个 可 以 重 与 来 保存 活动 状态 的 事件 。 


m "| N 


练习 答案 参见 附录 C。 


LinearLayout 以 单行 或 单列 的 形式 排列 视图 

AbsoluteLayout 可 用 于 指定 其 子 元 素 的 确切 位 置 

TableLayout 以 行 和 列 的 形式 组 织 视 图 

RelativeLayout 可 用 于 指定 子 视图 相对 于 彼此 之 间 是 如 何 定 位 的 
FrameLayout 一 个 在 屏幕 上 可 以 用 来 显示 单个 视图 的 占 位 符 


一 种 特殊 类 型 的 FrameLayout， 因 为 它 可 以 使 用 户 滚动 显示 一 个 占据 的 空 
间 大 于 物理 显示 的 视图 列表 


度量 单位 使 用 dp 指定 视图 尺寸 ， 使 用 sp 指定 字体 大 小 
适应 方 问 变化 的 两 种 方法 锚 定 与 调整 大 小 和 重新 定位 
为 不 同方 回 使 用 不 同 的 XML 文件 纵 回 用 户 界 面 使 用 layout 文 件 夹 ， 横 回 用 户 界面 使 用 layout-land 文 件 夹 


使 用 onPause0 事 件 
保持 活动 状态 的 3 种 方法 使 用 onSaveInstanceState() 事 件 
使 用 onRetainNonConfieurationInstance() 事 件 


ScrollView 


获得 当前 设备 的 尺寸 使 用 WindowManager 类 的 getDefaultDisplay() 方 法 


使 用 setRequestOrientation() 方 法 或 者 AndroidManifest.xml 文 件 中 的 


限制 活动 的 方 四 android:screenOrientation 属 性 
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本 章 将 介绍 以 下 内 容 

e 如 何 使 用 Android 中 的 基本 视图 设计 用 户 界面 

e 如何 使 用 选取 如 视图 显示 项 列表 

e ”如何 使 用 列表 视图 显示 项 列表 

第 3 章 中 学 习 了 可 以 用 来 在 一 个 活动 中 定位 视图 的 不 同 布局 ， 还 学 习 了 可 以 用 来 适应 不 同 
屏 医 分 状 京 和 尺寸 的 相关 技术 。 本 半 中 ， 您 将 了 解 到 可 以 用 来 为 应 用 程序 设计 用 户 界 面 的 各 
种 视图 。 

特别 地 ， 将 学 习 到 以 下 视图 组 : 

e ”基本 视图 第 用 的 视图 ， 如 TextView、EditText 和 Button 视 图 

e VD 可 以 使 用 户 从 一 个 列表 中 进行 选择 的 视图 ， 如 TimePicker 和 DatePicker 视 图 

多 ”列表 视图 显示 长 的 项 列表 的 视图 ， 如 ListView 和 SpinnerView 视 轿 

随后 的 草 广 将 涵 六 本草 未 讨论 到 的 其 他 视图 ， 如 日 斯 和 时 间 的 选取 器 视图 以 及 用 于 显示 图 
形 的 其 他 视图 等 。 


4.1 基本 视图 


首先 ， 我 们 探究 一 些 可 以 用 于 设计 Android 应 用 程序 的 用 户 界 面 的 基本 视图 : 
TextView 
EditText 
Button 
ImageButton 
CheckBox 
TogegleButton 
RadioButton 
RadioGroup 
这 些 基本 视图 可 以 用 来 显示 文本 信息 以 及 执行 一 些 基本 的 选择 。 下 面 的 章节 将 详细 研究 所 
有 这 些 视图 。 
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4.1.1 TextView 视 图 


当 创 建 一 个 新 的 Android 项 目 时 ，Eclipse 将 创建 一 个 包含 <TextView> 元 素 的 main.xml 文 件 (位 
于 res/layout 文 件 夹 下 ): 

«?xml version-"1.0" encoding-"utf-8"?-» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 

«TextView 
android:layout width-"ftill parent" 
android:layout height-"wrap content" 
android:text-"(üstring/hello" 
/> 


</LinearLayout> 


TextView 视 图 用 来 回 用 户 显 示 文 本 。 这 是 最 基本 的 视图 ， 在 开发 Android 应 用 程序 时 会 频繁 
用 到 。 如 果 想 让 用 户 可 以 编辑 显示 的 文本 ， 则 应 该 使 用 TextView 的 子 类 一 一 EditText，4.1.2 节 将 


讨论 它 。 


注意 : 在 某 些 平台 上 ，TextView 第 被 称 为 标签 视图 。 其 唯一 的 目的 就 是 在 


FALERA, 


4.1.2 Button, ImageButton, EditText, CheckBox, ToggleButton, 
RadioButton 和 RadioGroup 视 图 


除了 最 经 常用 到 的 TextView 视 图 之 外 ， 还 有 其 他 一 些 您 将 频繁 使 用 到 的 基本 控件 : 
Button、ImageButton、EditText、CheckBox、ToggleButton、RadioButton 和 RadioGroup。 


€ ”Buttoo 一 一 表示 一 个 按钮 的 小 部 件 。 

€ ImageButton 一 一 与 Button 视 图 类 似 ， 男 外 还 显示 一 个 图 像 。 

€ EditText 一 一 TextView 视 图 的 子 类 ， 男 外 还 允许 用 户 编辑 其 文本 内 容 。 

€ CheckBox 一 一 具有 两 个 状态 的 特殊 按钮 类 型 : 选中 或 未 选中 。 

@ RadioGroup 和 RadioButton RadioButton 有 两 个 状态 : 选中 或 未 选中 。 一 旦 一 个 


RadioButton 被 选中 ， 它 就 不 能 被 取消 选中 了 。RadioGroup 用 来 把 一 个 或 多 个 RadioButton 视 
图 组 合 在 一 起 ， 从 而 在 该 RadioGroup 中 只 允许 一 个 RadioButton 被 选中 。 

€ ToggleButton 一 一 用 一 个 灯光 指示 器 来 显示 选中 /未 选中 状态 。 

下 和 面 的 “ 试 一 试 ” 揭 示 了 这 些 视 图 工作 原理 的 细节 。 


使 用 基本 视 
BasicViews1.zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 使 用 Eclipse， 按 图 4-1 所 示 创 建 并 命名 一 个 Android 项 目 。 
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uS New Android Project 


Mew Android Project 


Creates a new Android Project resource. 


Project name | BasicViewsl 


Contents 

@ Create new project in workspace 
(^C) Create project from existing source 
Use default location 


Location: | C;/Users/Wei-Meng Lee/ myneww orkspace/BasicViewsl | Browse... 


© Create project from existing sample 


Samples: | AccelerometerPlay 


Build Target 


Target Name Vendor Platform 
[^] Android 2.1-upda.. Android Open Source Project 

[^] Geogle APIs Google Inc. 

[7] Android 2.2 Android Open Source Project 

[^] Google APIs Google Inc. 

[7] GALAXY Tab Add.. Samsung Electronics Co., Ltd. 

Android 2.3 Android Open Source Project 

[^] Google APIs Google Inc. 


Standard Android platform 2.3 


Properties 
Application name — BasicViewsl 


Package name: net.learn2develop.BasicViewsl 


Create Activity: MainActivity 
Min SDK Version: [9 


注意 : 本 书后 续 创 建 的 项 目 中 的 各 项 字段 将 及 用 以 下 的 值 : 


€ Application Name: «project name> 


Package Name: net.learn2develop. <project name> 


& 
Q Create Activity: MainActivity 
0 Min SDK Version: 9 


(2) 在 位 于 res/layout 文 件 夹 下 的 main.xzml 文 件 中 添加 下 列 粗 体 显 示 的 元 素 : 


«?xml version-"1.0" encoding-"utf-8"?- 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 


«Button android:id-"(üirid/btnSave" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Save" /» 
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«Button android:id="@+id/btnOpen" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Open" /> 


«ImageButton android:id-"(icrid/btnImgl" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:src-"(idrawable/icon" /> 


«EditText android:id-"(ic-id/txtName" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 


«CheckBox android:id="@+id/chkAutosave" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Autosave" /» 


«CheckBox android:id-"(ic-id/star" 
style-'"?android:attr/starStyle" 
android:layout width-"wrap content" 


android:layout height-"wrap content" /> 


<RadioGroup android:id="@+id/rdbGp1" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"vertical" » 
«RadioButton android:id-"(!id/rdbl" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Option 1" /» 
«RadioButton android:id-"(ü-id/rdb2" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Option 2" /» 
«/RadioGroup» 


«ToggleButton android:id-"'"(rid/togglel" 
android:layout width-"wrap content" 


android:layout height-"wrap content" /> 


</LinearLayout> 


(3) 要 观察 视图 的 效果 ， 可 在 Eclipse 中 选择 项 目 名 称 并 按 Fl11 键 进行 调试 。 图 4-2 展 示 了 在 
Android 模 拟 嚣 中 显示 的 不 同 视 图 。 
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图 4-2 
(4) 单 击 不 同 的 视图 并 注意 它们 在 外 观 和 感觉 上 的 变化 。 图 4-3 展 示 了 视图 的 以 下 改变 : 
€ 第 1 个 CheckBox 视 图 (Autosave) 被 选中 。 
e 第 2 个 CheckBox 视 图 ( 星 形 ) 被 选中 。 
e 第 2 个 RadioButton(Option 2) 被 选中 。 
€ ToggleButton 被 打开 。 


EAD 483 3:29am 


0000 


MPRA 
a wle fedr w luh ote 
PER on pu et dh n 


le 


示例 说 明 

到 目前 为 止 , 所 有 的 视图 都 是 相对 简单 的 一 一 使 用 <LinearLayout> 元 素 将 它们 一 一 列 出 ， 因 
此 当 在 活动 中 显示 时 ， 它 们 堆 登 在 彼此 之 上 。 

对 于 第 1 个 Button，layout_width 属 性 被 设置 为 fill _parent， 因 此 其 宽度 将 占据 整个 屏幕 
B vu E 
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«Button android:id="@+id/btnSave" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 


android:text-"Savo" /> 


XT 582^ ^Button, layout width 属性 被 设置 为 wrap_content， 因 此 其 宽度 将 是 其 所 包含 内 容 
的 宽度 一 一 具体 来 说 ， 就 是 显示 的 文本 (也 就 是 Open): 


«Button android:id-"84id/btnOpen" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 


android:text-"Open" /» 


ImageButton 显 示 了 一 个 市 有 图 像 的 按钮 。 图 像 通过 src 属 性 设置 。 本 例 中 ， 使 用 曾 用 作 应 用 
程序 图 标 | 


«ImageButton android:id-"gQ-id/btnimgi" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:src-"8Qdrawable/icon" /> 


EditText 视 图 显示 了 -一个 矩形 区 域 ， 用 户 可 以 向 其 中 输入 
一 些 文 本 。layout_height 属 性 被 设置 为 wrap_content， 这 样 ， 如 


果 用 户 输入 一 个 长 的 文本 串 ，EditText 的 高 度 将 随 腹 内 容 目 动 Ee 
调整 (如 图 4-4 所 示 )。 


«EditText android:id="@+id/txtName" 
android:layout width-"fill parent" 


图 4-4 


android:layout height-"wrap content" /> 


CheckBox 显 示 了 一 个 用 户 可 以 通过 轻 点 鼠标 进行 选中 或 取消 选中 的 复 选 框 : 


«CheckBox android:id-"Q8-id/chkAutosave" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 


android:text-"Autosavoe" /> 
A ARAS SEX CheckBoxll] SA iA P3, T EDSEECNLHI — P EEUU TE, [EXC Sio Dg f E S. 
如 是 形 : 
«CheckBox android:id-"8-cid/star" 
style-"?android:attr/starStyle" 


android:layout width-"wrap content" 


android:layout height-"wrap content" /» 
样式 属性 的 值 的 格式 如 下 所 示 : 
?[package:]|[type:] name 


RadioGroup 包 含 了 两 个 RadioButton。 这 一 点 很 重要 ， 因 为 单 选 按钮 通常 用 来 表示 多 个 选项 以 便 
用 户 选择 。 当 选择 了 RadioGroup 中 的 一 个 RadioButton 时 ， 其 他 所 有 RadioButton 就 自动 取消 选择 : 


«RadioGroup android:id-"8-id/rdbGpl" 


T1 
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android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"vertical" > 
«RadioButton android:id-"Q84id/rdbl" 
android:layout width-"frill parent" 
android:layout height-"wrap content" 
android:text-"Option 1" /» 
«RadioButton android:id-"grid/rdb2" 
android:layout width-"fi]l parent" 
android:layout height-"wrap content" 
android:text-"Option 2" /» 
«/RadioGroup» 


注意 ，RadioButton 是 年 直 排列 的 ， 一 个 位 于 另 一 个 之 上 上。 如果 想 要 水 平 排列 ， 需 要 把 
orientation 属 性 改 为 horizontal。 还 需要 确保 RadioButton 的 layout_width 属 性 被 设置 为 wrap_content: 


«RadioGroup android:id-"87id/rdbGpl" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" > 
«RadioButton android:id-"Q84id/rdbl" 

android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text- "Option 1" /> 
«RadioButton android:id-"grid/rdb2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Option 2" /» 
«/RadioGroup» 


图 4-5 显 示 了 水 平 排列 的 RadioButton 。 
ToggleButton 显 示 了 一 个 窍 形 按钮 ， 用 户 可 以 通过 单 击 它 
来 实现 开 和 关 的 切换 : ra 


«ToggleButton android:id-"( M id/togglel" 


Option 1 a Option 2 


android:layout width-"wrap content" 


android:layout height-"wrap content" /» 


这 个 例子 中 ， 始 终 保 持 一 致 的 
Button 视 图 中 所 示 : 


«Button android:id="@+id/btnSave" 


件 事情 是 每 个 视图 都 有 一 个 设置 为 特定 值 的 id 属性 ， 如 


android:layout width-"fill parent" 
android:layout height-"wrap content" 


android:text-"5avo" /> 


id 属性 是 视图 的 标识 符 ， 因 此 可 以 在 以 后 使 用 View.findViewById0 或 Activity.findViewById0O) 
方 法 来 检索 E [s] 
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现在 ， 您 已 经 了 解 了 一 个 活动 的 多 种 视图 的 外 观 ， 下 面 的 “ 试 一 试 ” 将 教 您 如 何以 编程 方 
式 探 制 它 们 。 


处 理 视图 事件 


(1) 使 用 前 面 的 “ 试 一 试 ” 所 创建 的 同一 个 项 目 ， 修 改 MainActivity.java 文 件 ， 添 加 下 列 粗 


package net.learn2develop.BasicViewsl; 


import android.app.Activity; 


import android.os.Bundle; 


import android.view.View; 

import android.widget.Button; 

import android.widget.CheckBox; 

import android.widget.RadioButton; 

import android.widget.RadioGroup; 

import android.widget.Toast; 

import android.widget.ToggleButton; 

import android.widget.RadioGroup.OnCheckedChangeListener; 


public class MainActivity extends Activity I{ 
/** 当 活动 第 一 次 被 创建 时 调用 。 */ 
aOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


/ / ---Buttonill E --- 
Button btnOpen = (Button) fidViewById(R.id.btnOpen); 
btnOpen.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) ( 
DisplayToast("You have clicked the Open button"); 


IA 


/ / -- -Button4ll E] - - - 
Button btnSave = (Button) fidViewById(R.id.btnSave); 
btnSave.setOnClickListener (new View.OnClickListener() 
{ 
public void onClick(View v) { 
DisplayToast("You have clicked the Save button"); 


)) ; 
/ / -- -CheckBox- -- 


CheckBox checkBox = (CheckBox) fidViewById(R.id.chkAutosave); 
checkBox.setOnClickListener(new View.OnClickListener() 
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{ 
public void onClick(View v) { 
if (((CheckBox)v).isChecked()) 
DisplayToast("CheckBox is checked"); 
else 
DisplayToast("CheckBox is unchecked"); 
} 
); 


/ / --- RadioButton--- 
RadioGroup radioGroup = (RadioGroup) findViewById (R.id.rdbGpl); 
radioGroup.setOnCheckedChangeListener (new OnCheckedChangeListener () 
{ 
public void onCheckedChanged(RadioGroup group, int checkedId) { 
RadioButton rbl = (RadioButton) findViewById (R.id.rdb1); 
if (rbl.isChecked()) { 
DisplayToast("Option 1 checked!"); 
) else ( 
DisplayToast("Option 2 checked!"); 


)); 


/ / --- ToggleButton--- 
ToggleButton toggleButton - 

(ToggleButton) findViewById (R.id.togglel); 
toggleButton.setOnClickListener (new View.OnClickListener () 


{ 
public void onClick(View v) { 
if (((ToggleButton)v).isChecked()) 
DisplayToast("Toggle button is On"); 
else 
DisplayToast("Toggle button is Off"); 
} 
); 


private void DisplayToast(String msg) 
i 
Toast.makeText(getBaseContext(), msg, 


Toast.LENGTH SHORT).show(); 


(2) 按 F11 键 在 Android 模 拟 器 中 调试 项 目 。 
(3) 单 击 不 同 的 视图 ， 观 察 在 Toast 窗 口中 显示 的 消息 。 


示例 说 明 
为 了 处 理 每 一 个 视图 所 触发 的 事件 ， 首 先 需 要 以 编程 方式 定位 在 onCreate0 事 件 中 所 创建 的 
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视图 。 做 法 是 使 用 Acitivity.findViewById0O) 方 法 ， 传 入 该 视图 的 I 有 D。 


/ / ---Buttondll E] - -— 

Button btnOpen = (Button) findViewById (R.id.btnOpen); 
setOnClickListener0 方 法 注册 一 个 回调 函数 ， 以 便 在 后 面 视 图 被 单 击 时 调用 。 

btnOpen.setOnClickListener(new View.OnClickListener() | 


public void onClick(View v) 1 
DisplayToast("You have clicked the Open button"); 


)); 
当 单 击 视图 时 ， 将 调用 onClickO 方 法 。 
对 于 CheckBox， 为 了 确定 其 状态 ， 必 须 把 onClickO 方 法 的 参数 类 型 转换 成 一 个 CheckBox， 
然后 检查 它 的 isChecked(O 方 法 来 确定 其 是 否 被 选中 : 


/ / - ——CheckBox--- 
CheckBox checkBox = (CheckBox) findViewById(R.id.chkAutosave); 


checkBox.setOnClickListener(new View.OnClickListener() 


{ 
public void onClick(View v) { 
if (((CheckBox)v).isChecked()) 
DisplayToast("CheckBox is checked"); 
else 
DisplayToast("CheckBox is unchecked"); 
} 
1); 


对 于 RadioButton， 需 要 使 用 RadioGroup 的 setOnCheckedChangeListener() 方 法 注册 一 个 回调 
国 数 ， 以 便 在 该 组 中 被 选中 的 RadioButton 发 生变 化 时 调用 : 


/ / ---HadioButton--- 
RadioGroup radioGroup - (RadioGroup) findViewById (R.id.rdbGpl); 
radioGroup.setOnCheckedChangeListener (new OnCheckedChangeListener () 
{ 
public void onCheckedChanged (RadioGroup group, int checkedId) | 
RadioButton rbl = (RadioButton) findViewById (R.id.rdbl); 
if (rbl.isChecked()) í( 
DisplayToast("Option l checked!"); 
} else 1{ 
DisplayToast("Option 2 checked!"); 


)); 
当选 中 一 个 RadioButton 时 ， 将 触发 onCheckedChanged(0) 方 法 。 在 这 一 过 程 中 ， 找 到 那些 单 
个 的 RadioButton， 然 后 调用 它们 的 isChecked0 〇 方法 来 确定 是 哪个 RadioButton 被 选中 。 或 者 ， 
onCheckedChanged0 方 法 包含 第 2 个 参数 ， 其 中 包含 被 选 定 RadioButton 的 唯一 标识 符 。 
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4.1.3 ProgressBar § 


ProgtessBar 视 图 提供 了 一 些 正 在 进行 的 任务 的 视觉 反馈 ， 如 当 您 在 后 台 执 行 一 个 任务 
时 。 例 如 ， 您 可 能 正 从 Web 上 下 载 一 些 数据 并 需要 更 独 用 户 的 下 载 状 态 。 在 这 种 情况 下 ， 使 用 
ProgressBar 视 图 来 完成 这 一 任务 是 一 个 不 错 的 选择 。 


使 用 ProgressBar 视 图 
BasicViews2.zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews2 的 Android 项 目 。 
(2) 修改 位 于 res/layout 文 件 夹 下 的 main.xml 文 件 ， 添 加 下 列 粗 体 显 示 的 代码 : 


«?xml version-"1.0" encoding-"utfí-8"?- 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"ftill parent" 
android:layout height-"fill parent" > 


«ProgressBar android:id-"(ü(irid/progressbar" 
android:layout width-"wrap content" 


android:layout height-"wrap content" /> 
</LinearLayout> 


(3) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.BasicViews2; 


import android.app.Activity; 


import android.os.Bundle; 


import android.os.Handler; 
import android.widget.ProgressBar; 


public class MainActivity extends Activity I 


private static int progress; 
private ProgressBar progressBar; 
private int progressStatus - 0; 


private Handler handler = new Handler(); 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


progress = 0; 
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progressBar = (ProgressBar) findViewById(R.id.progressbar); 


//--- 在 后 台 线 程 中 做 一 些 工作 --- 


new Thread(new Runnable() 


{ 
public void run() 
t 
//--- 这 里 做 一 些 工作 --- 
while (progressStatus < 10) 
{ 
progressStatus - doSomeWork(); 
) 
//--- 隐 藏 进 度 条 --- 
handler.post(new Runnable() 
{ 
public void run() 
i 
//---0 - VISIBLE; 4 - INVISIBLE; 8 - GONE--- 
progressBar.setVisibility (8); 
} 
)); 
) 
//--- 这 里 做 一 些 费 时 的 工作 --- 
private int doSomeWork () 
t 
try ( 
//--- 模 拟 做 一 些 工作 --- 
Thread.sleep(500); 
) catch (InterruptedException e) 
{ 
e.printStackTrace(); 
} 
return --progress; 
] 
) .start(); lisse cota 


(4) 按 F11 键 在 Android 模 拟 器 中 调 
试 项 目 。 图 4-6 显 示 了 ProgressBar 的 动 
画 。 大 约 5 秒 钟 后 ， 它 将 消失 。 

示例 说 明 
定 的 一 一 也 就 是 说 ， 它 显示 一 个 循环 
的 动画 。 这 种 模式 对 于 完成 时 间 没 有 
明确 指示 的 任务 是 非常 有 用 的 ， 例 如 
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当 您 回 一 个 Web 服 务 上 友 送 一 些 数 据 并 等 符 服 务 器 的 啊 应 时 。 如 条 只 是 把 <ProgressBar> 元 素 放 入 main. 
xm 文件 中 ， 它 会 不 断 地 显示 一 个 旋转 的 图 标 。 当 后 台 任务 已 经 完成 时 ， 需 要 您 来 使 它 停止 旋转 . 

己 在 Java 文 件 中 添加 的 代码 显示 了 如 何 分 配 一 个 后 台 线 程 来 模拟 执行 一 些 长 时 间 运 行 的 任 
务 。 要 做 到 这 一 点 ， 可 以 配合 使 用 Thread 类 和 一 个 Runnable 对 象 。run() 方 法 局 动 线程 的 执行 ， 在 
这 种 情况 下 调用 doSomeWork0) 方 法 来 模拟 做 一 些 工作 。 当 模拟 工作 完成 后 (大 约 5 秒 种 之 后 )， 使 
用 Handler 对 和 象 给 线程 发 送 一 条 消 忆 来 取消 ProgressBar: 


//--- 在 后 台 线 程 中 做 一 些 工 作 --- 


new Thread (new Runnable() 


{ 
public void run() 
{ 
//--- 这 里 做 一 些 工作 --- 
while (progressStatus « 10) 
{ 
progressStatus = doSomeWork(); 
} 
//--- 隐 藏 进度 条 --- 
handler.post(new Runnable () 
{ 
public void run() 
1 
//-—-0 - VISIBLE; 4 - INVISIBLE; 8 - GONE--- 
progressBar.setVisibility(8); 
} 
1); 
) 


//--- 这 里 做 一 些 费 时 的 工作 --- 
private int doSomeWork() 
{ 
try 1 
//--- 模 拟 做 一 些 工作 --- 
Thread.slieep(500); 
} catch (InterruptedException e) 
i 
e.printStackTrace(); 
} 
return ttprogress; 
} 
}) .start (); 


当 任 务 完 成 时 ， 通 过 设置 ProgressBar 的 Visibility 属 性 为 GONE( 值 8) 来 隐藏 它 。INVISIBLE 和 
GONE 第 量 的 区 别 在 于 INVISIBLE 和 常量 只 是 隐藏 ProgressBar(ProgressBar 所 占 区 域 仍旧 在 活动 中 
占据 空间 )。GONE 向 量 则 从 活动 中 移 除 ProgressBar 视 图 ， 不 由 占据 任何 空间 。 

下 面 的 “ 试 一 试 ” 演 示 了 如 何 改变 ProgressBar 的 外 观 。 
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定制 ProgressBar 视 图 


(1) 使 用 前 面 的 “ 试 一 试 ” 中 所 创建 的 同一 个 项 目 ， 按 如 下 所 示 修 改 main.xml 文 件 : 


<2xml version-"1.0" encoding-"utf-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" » 


«ProgressBar android:id-"8cid/progressbar" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 


style-'"?android:attr/progressBarStyleHorizontal" /> 


«/LinearLayout» 


(2) 修改 MainActivity.java 文 件 ， 添 加 下 列 粗 体 显示 的 语句 |: 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


progress = 0; 
progressBar = (ProgressBar) findViewById(R.id.progressbar); 


progressBar.setMax (200); 


/ / -— a & RERET E- 
new Thread (new Runnable() 
i 
public void run () 
{ 
//--- 这 里 做 一 些 工 作 --- 
while (ProgressStatus < 100) 


{ 
progressStatus = doSomeWork(); 
//--- 更 新 进度 条 --- 
handler.post(new Runnable () 
{ 
public void run() ( 
progressBar.setProgress(progressStatus); 
f 
)); 
} 


//--- 隐 藏 进度 条 --- 


handler.post(new Runnable() 
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{ 
public void run() 
1 
//[---0 - VISIBLE; 4 - INVISIBLE; 8 - GONE--- 
progressBar.setVisibility(8); 
} 
}); 


//--- 这 里 做 一 些 费 时 的 工作 --- 
private int doSomeWork () 
{ 
try { 
//--- 模 拟 做 一 些 工作 --- 
Thread.sleep (50); 
} catch (InterruptedException e) 


{ 


e.printstackTrace () 7 


} 


return -ttprogress; 
} 
}) .start (); 


(3) 按 F11 键 在 Android 模 拟 器 中 调试 项 目 。 
(4) 图 4-7 展 示 了 正 显 示 进 度 的 ProgressBar。 当 进度 达到 50% 时 ，ProgressBar 消 失 。 


$4 5554:Android 2.2 Emulator 


ERAN 4B 2:35 am 


示例 说 明 
为 了 使 ProgressBar 水 平 显示 ， 只 要 设置 其 style 属 性 为 ?android:attr/progressBarStyleHorizontal: 
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«ProgressBar android:id="@+id/progressbar" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
style-"?android:attr/progressBarStyleHorizontal" /» 


为 了 显示 进度 ， 调 用 setProgress0) 方 法 ， 传 入 一 个 表示 进度 的 整数 : 


//--- 更 新 进度 条 --- 
handler.post(new Runnable() 
( 

public void run() ( 


progressBar.setProgress (progressStatus); 
Ib: 


在 本 例 中 ， 设 置 了 ProgressBar 的 范围 为 0 一 200( 通 过 setMax(0) 方 法 )。 因 此 ，ProgressBar 将 在 
中 途 停止 并 消失 (由 于 仅仅 在 progressStatus 小 于 100 时 才 持 续 调 用 doSomeWork() 方 法 )。 为 了 确 
保 ProgressBar 只 有 当 进 度 达 到 100% 时 才 消 失 ， 可 以 设置 最 大 值 为 100， 或 者 修改 while 循 环 为 当 
progressStatus 达 到 200 时 就 停止 ， 如 下 所 示 : 


//--- 这 里 做 一 些 工作 --- 
while (progressStatus < 200) 


4.1.4 AutoCompleteTextView 视 图 


AutoCompleteTextView 是 一 种 与 EditText 类 似 的 视图 (实际 上 ， 它 是 EditText 的 子 类 )， 
男 外 它 还 在 用 户 输 入 时 目 动 显示 完成 建议 的 列表 。 下 面 的 “ 试 一 试 ” 展 示 了 如何 利用 
AutoCompleteTextView 来 目 动 协助 用 户 完 成 文本 输入 : 


使 用 AutoCompleteTextView 


BasicViews3. zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews3 的 Android 项 目 。 
(2) 按 如 下 粗 体 显示 内 容 修改 位 于 reslayout 文 件 夹 下 的 main.xml 文 件 : 


«?xml version-"1.0" encoding-"utf-8"?- 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 


android:layout height-"fill parent" > 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Name of President" /- 
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«AutoCompleteTextView android:id-"-id/txtCountries" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 


</LinearLayout> 


(3) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.BasicViews3; 


import android.app.Activity; 


import android.os.Bundle; 


import android.widget.ArrayAdapter; 
import android.widget.AutoCompleteTextView; 


public class MainActivity extends Activity I 

String[] presidents = ( 
"Dwight D. Eisenhower", 
"John F. Kennedy", 
"Lyndon B. Johnson", 
"Richard Nixon", 
"Gerald Ford", 
"Jimmy Carter", 
"Ronald Reagan", 
"George H. W. Bush", 
"Bill Clinton", 
"George W. Bush", 
"Barack Obama" 


F 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate (Bundle savedInstanceState) 1 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


ArrayAdapter«cString» adapter = new ArrayAdapter«String»(this, 
android.R.layout.simple dropdown item lline, presidents); 


AutoCompleteTextView textView — (AutoCompleteTextView) 
findViewById(R.id.txtCountries); 


textView.setThreshold(3); 
textView.setAdapter (adapter); 


(4) 按 Fl11 键 在 Android 模 拟 器 中 调试 应 用 程序 。 如 图 4-8 所 示 ， 在 问 AutoCompleteTextView 中 
输入 时 ， 会 随 之 显示 一 个 匹配 名 字 的 列表 。 
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示例 说 明 
在 MainActivity 类 中 ， 首 先 创建 了 一 个 包 舍 一 组 总 统 名 字 的 String 数 组 : 


String[] presidents = { 
"Dwight D. Eisenhower", 
"John F. Kennedy", 
"Lyndon B. Johnson", 
"Richard Nixon", 
"Gerald Ford", 
"Jimmy Carter", 
"Ronald Reagan", 
"George H. W. Bush", 
"Bill Clinton", 
"George W. Bush", 
"Barack Obama" 


}; 


ArrayAdapter 对 和 销 省 理 将 由 AutoCompleteTextView 显 示 的 字符 串 数组 。 在 先前 的 例子 中 ， 将 
AutoCompleteTextView 设 置 为 以 simple_dropdown item_lline 模 式 显 示 : 


ArravyAdapter<String> adapter = new ArrayAdapter<String> (this, 
android.R.layout.simple dropdown item lline, presidents); 


setThreshold() 7 i: Vx ECCE LUI F Tre "POE aX B BUB FP TRU ATE ee ^b EP RC: 


textView.setThreshold(3); 
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为 AutoCompleteTextView 显 示 的 建议 列表 从 ArrayAdapter 对 象 获得 : 


textView.setAdapter (adapter); 


4.2. ME HX gg 4 [E] 


选择 日 期 和 时 间 是 您 在 一 个 移动 应 用 程序 中 需要 执行 的 癌 见 任务 之 一 。Android 通 过 
TimePicker 和 DatePicker 视 图 来 支持 这 一 功能 。 下 面 的 小 节 将 阐述 如 何在 活动 中 使 用 这 些 视图 。 


4.2.1 TimePicker 视 图 


TimePicker 视 图 可 以 使 用 户 按 24 小 时 或 AM/PM 模 式 选择 一 天 中 的 某 个 时 间 。 下 面 的 “ 试 一 
试 ”展示 了 如 何 使 用 这 一 视图 。 


使 用 TimePicker 视 图 
BasicViews4.zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews4 的 Android 项 目 。 
(2) 修改 位 于 res/layout 文 件 夹 下 的 main.xml 文 件 ， 添 加 下 列 粗 体 显 示 的 行 : 


<?xml version-"1.0" encoding="utćf-8"?> 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 


android:layout height-"fill parent" > 


«TimePicker android:id-"(id/timePicker" 
android:layout width-"wrap content" 


android:layout height-"wrap content" /? 


«Button android:id-"(ü(rid/btnSet" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"I am all set!" /» 


«/LinearLayout» 


(3) 按 F11 键 在 Android 模 拟 器 中 调试 应 用 程序 。 图 4-9 显 示 了 运用 中 的 TimePicker。 除 了 单 击 
加 (+) 和 减 (-) 按 钮 外 ， 还 可 以 使 用 设备 上 的 数字 键盘 来 修改 小 时 和 分 钟 ， 单 击 AM 按 钮 在 AM 和 
PM 之 间 切 换 。 
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W^ 5554ndroid 2.2 Emulator 


aM e 1:29 av 


BasicViews4 


] am all set! 


(4) 返回 Eclipse， 在 MainAcitivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
package net.learn2develop.BasicViews4; 


import android.app.Activity; 


import android.os.Bundle; 


import android.view.View; 
import android.widget.Button; 
import android.widget.TimePicker; 


import android.widget.Toast; 


public class MainActivity extends Activity I{ 


TimePicker timePicker; 


/[** 当 活动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


timePicker - (TimePicker) findViewById(R.id.timePicker); 
timePicker.setIs24HourView(true); 


Ea 
E -—  —Á 8c X—-— 


/ / -- -Button4li 
Button btnOpen = (Button) fidViewById(R.id.btnSet); 
btnOpen.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
Toast.makeText(getBaseContext(), 
"Time selected:" + 
timePicker.getCurrentHour() 十 


":"  timePicker.getCurrentMinute(), 
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Toast.LENGTH SHORT).show(); 


PES 


(5) 按 F1l1 键 在 Android 模 拟 器 上 调试 应 用 程序 。 这 一 次 ，TimePicker 将 以 24 小 时 格式 显示 。 
单 击 Button 将 显示 您 在 TimePicker 中 设置 好 的 时 间 ( 如 图 4-10 所 示 )。 


4 5554kAndroid 2.2 Emulator 


^de 
am alsen 四 ee 


n2jaj4js |e|z js |o |o- 


Time saelected:1:33 


示例 说 明 


TimePicker 显 示 了 一 个 可 以 让 用 户 设置 时 间 的 标准 用 户 界 面 。 黑 认 情 况 下 ， 它 以 AMPM 格 
式 显 示 时 间 。 如 果 想 要 以 24 小 时 格式 来 显示 ， 可 以 使 用 setIs24HourView0 方 法 。 
为 了 以 编程 方式 获得 用 户 设置 的 时 间 ， 可 以 使 用 getCurrentHour() 和 getCurrentMinute() 方 法 : 
Toast .makeText (getBaseContext (), 


"Time selected:" + 


timePicker.getCurrentHour() + 


":" + timePicker.getCurrentMinute(), 
Toast.LENGTH SHORT).show(); 


注意 : getCurrentHour() 方 法 总 是 返回 24 小 时 格式 的 时 间 ， 也 就 是 返回 一 个 
0~23 之 间 的 值 。 


在 对 话 框 窗口 中 显示 TimePicker 


虽然 可 以 在 一 个 活动 中 显示 TimePicker， 但 更 好 的 方法 是 在 一 个 对 话 框 窗口 中 显示 它 。 这 样 
一 旦 设置 好 时 间 ，TimePicker 束 会 消失 ， 不 绸 占据 活动 中 的 任何 空间 。 下 面 的 “ 试 一 试 ” 展 示 了 
如 何 做 到 这 一 点 。 
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使 用 对 话 框 显示 TimePicker 视 图 


(1) 使 用 先前 “ 试 一 试 ” 中 所 创建 的 同一 个 项 目 ， 按 如 下 所 示 修 改 MainActivity.java 文 件 : 


package net.learn2develop.BasicViews4; 


import android.app.Activity; 
import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 
import android.widget.TimePicker; 


import android.widget.Toast; 


import android.app.Dialog; 
import android.app.TimePickerDialog; 


public class MainActivity extends Activity I 


TimePicker timePicker; 


int hour, minute; 
static final int TIME DIALOG ID = 0; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


showDialog (TIME DIALOG ID); 


timePicker = (TimePicker) findViewById(R.id.timePicker); 


timePicker.setIs24HourView(true); 


/ / -—Button4W É -—— 
Button btnOpen = (Button) findViewById(R.id.btnSet); 


btnOpen.setOnClickListener(new View.OnClickListener () 


public void onClick(View v) I 
Toast.makeText(getBaseContext (), 


"Time selected:" + 


timePicker.getCurrentHour().toString(í() + 
":" + LimePicker.getCurrentMinute () . toString(), 


Toast.LENGTH SHORT).show(); 


)); 


aüQOverride 
protected Dialog onCreateDialog(int id) 
i 

switch (id) { 
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case TIME DIALOG ID: 
return new TimePickerDialog( 
this, mTimeSetListener, hour, minute, false); 
] 


return null; 


private TimePickerDialog.OnTimeSetListener mTimeSetListener = 


new TimePickerDialog.OnTimeSetListener () 


{ 
public void onTimeSet( 
TimePicker view, int hourOfDay, int minuteOfHour) 
{ 
hour - hourOfDay; 
minute = minuteOfHour; 
Toast.makeText(getBaseContext(), 
"You have selected : " + hour + ":" + minute, 
Toast.LENGTH SHORT).show(); 
] 
}; 


(2) 按 Fl1 键 在 Android 模 拟 器 中 调试 应 用 程序 。 当 活动 被 加 载 时 ， 可 以 看 到 TimePicker 显 示 
在 一 个 对 话 框 窗口 内 (如 图 4-11 所 示 )。 设 置 一 个 时 间 ， 然 后 单 击 Set 按 钮 ， 将 看 到 Toast 窗 口 显 示 
了 您 刚刚 设置 好 的 时 间 。 


- 5554: Andreid 2.7 Emulator 
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图 4-11 
示例 说 明 
为 了 显示 一 个 对 话 框 窗口 ， 可 以 使 用 showDialog() 方 法 ， 传 入 一 个 ID 来 标识 对 话 框 的 源 ; 
showDialog (TIME DIALOG ID); 
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当 调 用 showDialog(0) 方 法 时 ，onCreateDialog(0) 方 法 将 被 调用 : 


QOverride 
protected Dialog onCreateDialog(int id) 
1 

switch (id) 1 

case TIME DIALOG ID: 
return new TimePickerDialogq( 
this, mTimeSetListener, hour, minute, false); 
} 


return null; 


这 里 ， 创 建 了 一 个 TimePicker 类 的 新 实例 ， 给 它 传递 了 当前 上 下 文 、 回 调 函 数 、 初 始 的 小 时 
和 分 钟 ， 以 及 TimePicker 是 否 以 24 小 时 格式 显示 的 布尔 常量 。 
当 用 户 单 击 TimePicker 对 话 框 窗口 中 的 Set 按 钮 时 ， 将 调用 onTimeSetO 方 法 : 
private TimePickerDialog.OnTimeSetListener mTimeSetListener = 


new TimePickerDialog.OnTimeSetListener () 


{ 
public void onTimeSet( 
TimePicker view, int hourOfDay, int minuteOfHour) 
{ 
hour = hourOfDay; 
minute = minuteOfHour; 
Toast.makeText(getBaseContext (), 
"You have selected : " + hour + ":" + minute, 
Toast.LENGTH SHORT).show(); 
} 
); 


这 里 ，onTiemSet() 方 法 将 包含 用 户 分 别 通 过 hourOfDay 和 minuteOfHour 参 数 设 置 的 小 时 和 
分 钟 。 


4.2.2 ”DatePicker 视 图 


与 TimePicker 类 似 的 另外 一 种 视图 就 是 DatePicker。 利 用 DatePicker， 可 以 使 用 户 在 活动 中 选 
择 一 个 特定 的 日 期 。 下 面 的 “ 试 一 试 ” 展 示 了 如 何 使 用 DatePicker。 


使 用 DatePicker 视 图 


(1) 使 用 前 述 “ 试 一 试 ” 中 创建 的 同一 个 项 目 ， 按 如 下 所 示 修 改 main.xml 文 件 : 


<?xml version-"1.0" encoding-"utf-8"?- 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 


android:layout width-"fill parent" 
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android:layout height-"fill parent" > 


«DatePicker android:id-"(-id/datePicker" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 


«TimePicker android:id-"8-cid/timePicker" 
android:layout width-"wrap content" 


android:layout height-"wrap content" /» 

«Button android:id-"G8-4cid/btnSet" 
android:layout width-"wrap content" 
android:layout height-" 


android:text-"I am all set!" /» 


wrap content" 


«/LinearLayout» 


(2) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 图 4-12 显 示 了 DatePicker 和 TimePicker 视 图 。 


& S55S4Andraid 23 Emulator 
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4-12 
(3) 返回 Eclipse， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.BasicViews4; 


import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 


import android.widget.Button; 
import android.widget.Toast; 


import android.app.Dialog; 


import android.app.TimePickerDialog; 
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import android.widget.TimePicker; 


import android.widget.DatePicker; 


public class MainActivity extends Activity I 


TimePicker timePicker; 
DatePicker datePicker; 


int hour, minute; 
static final int TIME DIALOG ID = 0; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 


public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 
//showDialog(TIME DIALOG ID); 


timePicker - (TimePicker) findViewById(R.id.timePicker); 


timePicker.setIs24HourView(true); 
datePicker = (DatePicker) fidViewById(R.id.datePicker); 


/ / - --Button4ll E - —— 

Button btnOpen = (Button) findViewById (R.id.btnSet); 

btnOpen.setOnClickListener(new View.OnClickListener() í( 

public void onClick(View v) { 
Toast.makeText(getBaseContext(), 

"Date selected:" + datePicker.getMonth() + 1 + 
"/" + datePicker.getDayOfMonth() + 
"/" + datePicker.getYear() + "Mn" + 
"Time selected:" + timePicker.getCurrentHour() + 
"sz" + timePicker.getCurrentMinute (), 
Toast.LENGTH SHORT).show(); 


)); 


(Override 


protected Dialog onCreateDialog(int id) 


{ 


switch (id) { 
case TIME DIALOG ID: 
return new TimePickerDialogq( 
this, mTimeSetListener, hour, minute, false); 
} 


return null; 
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private TimePickerDialog.OnTimeSetListener mTimeSetListener = 
new TimePickerDialog.OnTimeSetListener () 
Ü 
public void onTimeSet( 
TimePicker view, int hourOfDay, int minuteOfHour) 
{ 
hour = hourOfDay; 
minute — minuteOfHour; 
Toast.makeText(getBaseContext (), 
"You have selected : ™ + hour + ":" + minute, 
Toast.LENGTH SHORT).show(); 
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图 4-13 
示例 说 明 


与 TimePicker 类 似 ， 通 过 调用 getMonth()、getDayOfMonth() 和 getYear() 方 法 来 分 别 获取 月 


"Date selected:" + datePicker.getMonth() * 1 十 
"/" + datePicker.getDayOfMonth() + 
"/" + datePicker.getYear() + "Mn" + 


注意 ，getMonth() 方 法 返回 0 代表 一 月 、 返 回 1 代 表 二 月 ， 依 次 关 推 。 因 此 ， 需 要 将 此 方法 返 
回 的 结果 加 1 来 获得 月 份 数 。 
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在 对 话 框 窗口 中 显示 DatePicker 视 图 

像 TimePicker 一 样 ， 也 可 以 在 对 话 框 窗口 中 显示 DatePicker。 下 面 的 “ 试 一 试 ” 将 教 您 如 何 
做 到 这 一 点 。 
使 用 对 话 框 显示 DatePicker 视 图 


(1) 使 用 前 述 “ 试 一 试 ” 中 创建 的 同一 个 项 目 ， 修 改 MainActivity.java 文 件 ， 添 加 下 列 粗 体 
显示 的 语句 : 


package net.learn2develop.BasicViews4; 


import android.app.Activity; 


import android.os.Bundle; 


import android.view.View; 


import android.widget.Button; 
import android.widget.Toast; 


import android.app.Dialog; 


import android.app.TimePickerDialog; 


import android.widget.TimePicker; 


import android.widget.DatePicker; 


import android.app.DatePickerDialog; 
import java.util.Calendar; 


public class MainActivity extends Activity I 
TimePicker timePicker; 


DatePicker datePicker; 


int hour, minute; 


int yr, month, day; 


static final int TIME DIALOG ID = 0; 
static final int DATE DIALOG ID = 


| 
lA 
"= a 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 
//showDialog(TIME DIALOG ID); 


/7/--- 获 取 当 前 日 期 --- 
Calendar today = Calendar.getInstance(); 


13/7 
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yr = today.get(Calendar.YEAR); 

month = today.get(Calendar.MONTH); 

day = today.get(Calendar.DAY OF MONTH); 
showDialog (DATE DIALOG ID); 


timePicker = (TimePicker) findViewById(R.id.timePicker); 


timePicker.setlIs24HourView(true); 
datePicker = (DatePicker) findViewById(R.id.datePicker); 


/ /-—-ButtondWEÉ|--- 
Button btnOpen = (Button) findViewById(R.id.btnSet); 
btnOpen.setOnClickListener(new View.OnClickListener() | 
public void onClick(View v) { 
Toast.makeText(getBaseContext (), 
"Date selected:" + datePicker.getMonth(í) + 
"/" + datePicker.getDayOfMonth() + 
"/" + datePicker.getYear() + "Mn" + 
"Time selected:" + timePicker.getCurrentHour () 
":U + timePicker.getCurrentMinute(), 
Toast.LENGTH SHORT).show(); 


)); 


8aGOverride 


protected Dialog onCreateDialog(int id) 


1 


switch (id) 1 
case TIME DIALOG ID: 
return new TimePickerDialog( 
this, mTimeSetListener, hour, minute, false); 
case DATE DIALOG ID: 
return new DatePickerDialog( 
this, mDateSetListener, yr, month, day); 
} 


return null; 


private DatePickerDialog.OnDateSetListener mDateSetListener = 


new DatePickerDialog.OnDateSetListener () 
{ 
public void onDateSet( 
DatePicker view, int year, int monthOfYear, int dayOfMonth) 
{ 
yr 一 year; 
month - monthOfYear; 
day = dayOfMonth; 
Toast.makeText(getBaseContext(), 
"You have selected : " 十 (month 十 1) 十 


一 
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"/" + day + "/" + year, 
Toast.LENGTH SHORT).show(); 


Fs 


private TimePickerDialog.OnTimeSetListener mTimeSetListener = 
new TimePickerDialog.OnTimeSetListener() 
{ 
public void onTimeSet ( 
TimePicker view, int hourOfDay, int minuteOfHour) 
{ 
hour = hourOfDay; 
minute — minuteOfHour; 
Toast.makeText(qgetBaseContext (), 
"You have selected : " + hour + ":" + minute, 
Toast.LENGTH SHORT).show(); 


Fa 


(2) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 当 活动 加 载 时 ， 可 以 看 到 DatePicker 显 示 在 
一 个 对 话 框 窗口 中 (如 图 4-14 所 示 )。 设 定好 一 个 日 期 并 单 击 Set 按 钮 。Toast 窗 口 将 显示 出 您 刚刚 
设置 好 的 日 期 。 


ti 5554Android_2.2_Emulator 


à Sunday, November 14, 


示例 说 明 


DataPicker 和 TimePicker 的 工作 诛 理 是 一 致 的 。 当 设置 日 期 时 ， 它 将 触发 onDateSet(O) 方 法 ， 
从 中 可 以 获取 由 用 户 设 定 的 日 期 : 
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public void onDatesSet( 
DatePicker view, int year, int monthOfYear, int dayOfMonth) 


{ 
yr = year; 
month = monthOfYear; 
day = dayOfMonth; 
Toast.makeText(getBaseContext(), 
"You have selected : ”十 (month + 1) + 
"/" + day + "/" + year, 
Toast.LENGTH SHORT).show(); 
} 


注意 ， 在 显示 对 话 框 之 前 ， 需 要 初始 化 3 个 变量 
// 一 -获取 当前 日 期 --- 


Calendar today = Calendar.getInstance(); 
yr — today.get(Calendar.YEAR); 

month = today.get(Calendar.MONTH); 

day = today.get(Calendar.DAY OF MONTH); 
showDialog(DATE DIALOG ID); 


yr. month4llday: 


WRD, HEE TIE GUEE— ^ DatePickerDialog2S KAR, REIRES OE S 


(current should be >= start and <= end). 


4.3 列表 视图 


列表 视图 是 一 种 可 以 用 来 显示 长 的 项 列表 的 视图 。 在 Android 中 ， 有 两 种 列表 视图 : 
ListView 和 SpinnerView， 山 者 都 用 于 显示 长 的 项 列表 。 下 面 的 “ 试 一 试 ” 展 示 了 这 两 种 视图 的 
使 用 。 


4.3.1 ListView 视 图 


ListView 在 一 个 垂直 滚动 列表 中 显示 项 列表 。 下 面 的 “ 试 一 试 ” 演 示 了 如 何 使 用 ListView 显 
示 一 个 项 列表 。 


使 用 ListView 显 示 一 个 长 的 项 列表 


BasicViews5.zip4X #5 文件 可 以 在 Wroxcom 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews5 的 Android 项 目 。 
(2) 修改 MainActivity.java 文 件 ， 插 入 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.BasicViews5; 


import android.app.Activity; 
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import 


import 
import 
import 
import 
import 


public 


android.os.Bundle; 


android.app.ListActivity; 
android.view.View; 
android.widget.ArrayAdapter; 
android.widget.ListView; 
android.widget.Toast; 


class MainActivity extends LbistActivity I 


String[] presidents = ( 


"Dwight D. Eisenhower", 
"John F. Kennedy", 
"Lyndon B. Johnson", 
"Richard Nixon", 
"Gerald Ford", 

"Jimmy Carter", 

"Ronald Reagan", 
"George H. W. Bush", 
"Bill Clinton", 

"George W. Bush", 


"Barack Obama" 


); 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
dOverride 


public void onCreate (Bundle savedInstanceState) 


super.onCreate(savedInstanceState); 
/ / setContentView (R.layout.main); 


setListAdapter (new ArrayAdapter«cString»(this, 
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android.R.layout.simple list item 1, presidents)); 


public void onListItemClick( 


ListView parent, View v, int position, long id) 


{ 


Toast.makeText(this, 


"You have selected " + presidents [position], 


Toast.LENGTH SHORT).show(); 


(3) 按 F1l1 键 在 Android 模 拟 器 上 调试 应 用 程序 。 图 4-15 展 示 了 显示 总 统 名 字 列 表 的 活动 。 
(4) 单 击 一 个 列表 项 ， 将 显示 一 个 包含 所 选择 项 的 消 轧 。 
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i 5554Android_2.2_Emulator 
ea A 43 11:50am 


Dwight D. Eisenhower 


| John F. Kennedy 


Lyndon B. Johnson 
Richard Nixon 
| Gerald Ford 
| Jimmy Carter 


DAanalr| Daaean 


示例 说 明 
在 本 例 中 ， 首 先 要 注意 的 是 MainActivity 类 扩展 了 ListActivity 类 。ListActivity 类 扩展 了 
Activity 关 并 且 通 过 绑 定 到 一 个 数据 源 来 显示 一 个 项 列表 。 还 要 注意 ， 无 须 修 改 main.xml 文 件 来 
包含 ListView; ListActivity 类 本 喘 已 经 包含 了 一 个 ListView。 因 此 ， 在 onCreate() 方 法 中 ， 不 需要 
调用 setContentView(0) 方 法 来 从 main.xml 文 件 中 加 载 用 户 界面 : 
//--- 不 需要 调用 这 个 方法 --- 


//setContentView(R.layout.main); 


在 onCreate() 方 法 中 ， 使 用 setListAdapter() 方 法 来 用 一 个 ListView 以 编程 方式 填充 活动 的 整个 
屏 攻 。ArrayAdapter 对 象 管理 将 由 ListView 显 示 的 字符 串 数 组 。 在 前 面 的 例子 中 ， 将 ListView 设 
置 为 在 simple_list_item_1 模 式 下 显示 : 


setListAdapter(new ArrayAdaptercString» (this, 


android.R.layout.simple list item 1, presidents)); 


当 单 击 ListView 中 的 一 个 列表 项 时 ， 将 触发 onListItemClick0 方 法 : 


public void onListItemClick( 


ListView parent, View v, int position, long id) 


i 
Toast.makeText (this, 
"You have selected " + presidents[position], 
Toast.LENGTH SHORT).show(); 
] 


这 里 ， 只 是 使 用 Toast 类 来 显示 所 选择 的 总 统 名 子 。 


定制 ListView 
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ListView 是 一 个 可 以 进一步 定制 的 通用 控件 。 下 和 面 的 “ 试 一 试 ” 展 示 了 如 何 允 许 在 ListView 
中 选择 多 个 项 以 及 如 何 使 之 支持 贤 选 功能 。 


定制 ListView 


(1) 打开 前 一 节 中 创建 的 同一 个 项 目 ， 在 MainActivityjava 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


QMOverride 


public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView (R.layout.main); 


ListView lstView 


getListView(); 


//lstView.setChoiceMode (0); //CHOICE MODE NONE 
//lstView.setChoiceMode (1); //CHOICE MODE SINGLE 
lstView.setChoiceMode (2); //CHOICE MODE MULTIPLE 
lstView.setTextFilterEnabled(true); 


setListAdapter(new ArrayAdaptercString»(this, 


android.R.layout.simple list item checked, presidents)); 


public void onListItemClick( 


ListView parent, View v, int position, long id) 


{ 


//--- 打 上 在 列表 项 旁边 显示 的 勾 号 --- 
parent.setlItemChecked (position, parent.islItemChecked (position)); 


Toast.makeText (this, 


"You have selected " + presidents[position], 
Toast.LENGTH SHORT).show(); 


(2) TZF118E TE Android U 28 
击 每 个 项 以 显示 其 旁边 的 勾 号 图 
标 (如 图 4-16 所 示 )。 


示例 说 明 


为 了 以 编程 方式 获得 对 
ListView 对 象 的 引用 ， 可 以 使 用 
能 获取 ListActivity 的 表 视 图 的 
getListView() 方 法 。 想 要 以 编程 
方式 修改 ListView 的 行为 ， 就 需 
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setChoiceMode0 方 法 来 告诉 ListView 如 何 处 理 一 个 用 户 的 单 击 。 在 本 例 中 ， 设 置 其 为 2， 这 意味 
着 用 户 可 以 选择 多 个 项 ， 


//lstView.setChoiceMode (0); //CHOICE MODE NONE 
//lstView.setChoiceMode (1); //CHOICE MODE SINGLE 
lstView.setChoiceMode (2); //CHOICE MODE MULTIPLE 


ListView] — ^ dE ?5 B5 HJ) H6 X x RE Umi. UAI ILsetlextFilterEnabled() 7; 1;/d H T $03 
功能 ， 用 户 将 可 以 在 键盘 上 输入 并 且 ListView 将 自动 筛选 来 匹配 已 经 输入 的 内 容 : 
lstView.setTextFilterEnabled(true); 
图 4-17 显 示 了 起 作用 的 列表 筛选 功能 。 这 里 ， 列 表 中 所 有 包含 单词 john 的 项 将 在 结果 列表 中 
为 了 显示 每 一 个 项 劳 边 的 勺 与 图 标 ， 使 用 setItemCheckedO 方 法 : 
//--- 打 上 在 列表 项 旁边 显示 的 勾 号 --- 


parent.setItemChecked (position, parent.isltemChecked (position)); 


上 述 语句 将 在 用 户 单 击 每 一 个 项 时 ， 为 其 打上 义 号 图 标 。 
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图 4-17 
虽然 本 例 中 显示 了 总 统 名 罕 列 表 存 储 在 一 个 数组 中 ， 但 在 实际 的 应 用 中 ， 建 议 从 数据 库 中 


检索 它们 或 至 少将 它们 存储 在 strings.xml 文 件 中 。 下 面 的 “ 试 一 试 ” 展 示 了 这 一 点 。 
将 列表 项 存储 在 strings.xml 文 件 中 


(1) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 位 于 res/values 文 件 夹 下 的 strings.xml 文 件 中 添加 下 列 
粗 体 显示 的 行 : 


«?xml version-"1.0" encoding-"utfí-8"?- 
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«resources» 
«string name-"hello"»Hello World, MainActivity!«/string» 
«string name-"app name"»BasicViews5«/string» 
«string-array name-"presidents array"» 
X«item»Dwight D. Eisenhowerc/item» 
X«item»John F. Kennedy</ Item> 
«item»Lyndon B. Johnson«c/item» 
«item»Richard Nixon«/item» 
«item»Gerald Ford«/item» 
«item»Jimmy Carter«/item» 
X«item»Ronald Reagan«c«/item» 
«item»George H. W. Bush«/item» 
«item»Bill Clinton«c/item» 
X«item»George W. Bush«c«/item» 
«item»Barack Obama«/item» 
«/string-array» 


«/resources-» 


(2) 按 下 列 粗 体 显示 内 容 修改 MainActivity.java 文 件 : 


public class MainActivity extends ListActivity I 
String[] presidents; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

aOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


ListView lstView = getListView(); 
//lstView.setChoiceMode(0); //CHOICE MODE NONE 
//lstView.setChoiceMode (1); //CHOICE MODE SINGLE 
lstView.setChoiceMode (2); //CHOICE MODE MULTIPLE 
lstView.setTextFilterEnabled(true); 


presidents = 


getResources().getStringArray (R.array.presidents array); 


setListAdapter(new ArrayAdaptercString» (this, 


android.R.layout.simple list item checked, presidents)); 


public void onListItemClick( 


ListView parent, View v, int position, long id) 
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(3) 近 Fl1 键 在 Android 帆 拟 器 上 调试 应 用 程序 。 您 将 会 看 到 同 前 面 的 “ 试 一 试 ” 中 一 样 的 名 
TIK. 


示例 说 明 
由 于 现在 名 字 存 储 在 strings.xml 文 件 中 ， 上 所 以 可 以 在 这 个 MainActivity.java 文 件 中 使 用 
getResources0 方 法 以 编程 方式 来 检索 它 : 


presidents = 


getResources () .getstringArray (R.array.presidents array); 


一 般 地 ， 可 以 使 用 getResources() 方 法 以 编程 方式 来 检索 与 应 用 程序 捆绑 的 资源 。 


4.3.2 ”使 用 Spinner 视 图 


ListView 在 一 个 活动 中 显示 一 个 长 的 项 列表 ， 但 有 时 需要 在 用 户 界 面 上 显示 其 他 视图 ， 因 
此 没有 额外 的 空间 来 显示 像 ListView 这 样 的 全 屏 视 图 。 在 这 种 情况 下 ， 应 该 使 用 SpinnerView。 
SpinnerView 一 次 显示 列表 中 的 一 项 ， 并 可 以 使 用 户 在 其 中 进行 选择 。 

下 面 的 “ 试 一 试 ” 展 示 了 如 何在 活动 中 使 用 SpinnerView。 


使 用 SpinnerView 一 次 显示 一 个 项 


BasicViews6.zip 代 而 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews6 的 Android 项 目 。 
(2) 按 如 下 所 示 修 改 位 于 res/layout 文 件 夹 下 的 main.xml 文 件 : 


«?xml version-"1.0" encoding-"utf-8"?- 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 


«Spinner 
android:id-"(t4id/spinnerl" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:drawSelectorOnTop-"true" /» 


«/LinearLayout» 


(3) 把 下 列 粗 体 显 示 的 行 添加 a 到 位 于 res/values 文 件 夹 下 的 strings.xml 文 件 中 : 


<?xml version-"1.0" encoding-"utf-8"?-» 
«resources» 
«string name-"hello"»Hello World, MainActivity!c«/string» 


«string name-"app name"»BasicViewsó6«c/string» 
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<string-array name-"presidents array"> 
<item>Dwight D. Eisenhower</item> 
<item>John F. Kennedy</item> 
<item>Lyndon B. Johnson</item> 
<item>Richard Nixon</item> 
<item>Gerald Ford</item> 
<item>Jimmy Carter</item> 
<item>Ronald Reagan</item> 
<item>George H. W. Bush</item> 
<item>Bill Clinton</item> 
<item>George W. Bush</item> 
«item»Barack Obama</item> 
</string-array> 


«/resources» 


(4) fEMainActivity.java X fF Pi JU. bh TRIPS zn IR): 


package net.learn2develop.BasicViewso; 


import 


import 


import 
import 
import 
import 
import 
import 


public 


android 


android. 


android. 


android 
android 
android 


android. 
android. 


.app.Activity; 


os.Bundle; 


view.View; 

.Widget.AdapterView; 
.Widget.AdapterView.OnItemSelectedListener; 
.Widget.ArrayAdapter; 

widget.Spinner; 

widget.Toast; 


class MainActivity extends Activity I 


String[] presidents; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


QMOverride 


public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


presidents = 


使 用 视图 设计 用 户 界 面 


getResources().getStringArray (R.array.presidents array); 


Spinner sl = (Spinner) findViewById(R.id.spinnerl); 


ArrayAdapter«String» adapter = new ArrayAdapter«String» (this, 


android.R.layout.simple spinner item, presidents); 


sl.setAdapter (adapter); 
sl.setOnlItemSelectedListener (new OnItemSelectedListener () 


{ 


((Override 
public void onlItemSelected(AdapterView«?» arg0, View argl, 
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int arg2, long arg3) 


{ 
int index = arg0 .getSelectedItemPosition() : 
Toast.makeText(getBaseContext(), 
"You have selected item : " + presidents [index], 
Toast.LENGTH SHORT).show(); 
] 
(GOverride 
public void onNothingSelected(AdapterView«?» arg0) {} 


IM 


(5) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 单 击 SpinnerView， 可 以 看 到 弹出 一 个 显示 总 统 
名 字 的 列表 (如 图 4-18 所 示 )。 单 击 一 个 列表 项 将 显示 一 个 消息 ， 表 明 这 个 列表 项 被 选择 了 。 


d 5554:Android 2.2 Emulator 


Dwight D. Eisenhower 
John F. kennedy 
Lyndon B. Johnsan 
Richard Nixon 
Gerald Fard 
Jimmy Carter 
Ronald Reagan 
George H. W. Bush 
Bill Clinton 

(seorge W. Bush 
Barack Obama 


nl 
npn elie et 
z= 


4-18 


示例 说 明 


上 面 的 例子 与 ListView 的 工作 原理 很 相像 。 需 要 实现 的 一 个 额外 方法 是 onNothingSelected() 
方法 。 当 用 户 按 下 Back 按 钮 时 触发 这 一 方法 ， 撤 销 所 显示 的 项 列表 。 在 这 种 情况 下 ， 没 有 任何 
项 被 选择 ， 也 不 需要 作 任 何 处 理 。 

除了 在 ArrayAdapter 中 以 普通 列表 形式 显示 列表 项 之 外 ， 还 可 以 使 用 单 选 按钮 来 显示 它们 。 
要 做 到 这 一 点 ， 需 要 修改 ArrayAdapter 类 的 构造 函数 中 的 第 二 个 参数 : 


ArrayAdapter<String> adapter = new ArrayAāAdapter<String> (this, 
android.R.layout.simple spinner dropdown item, presidents); 


这 样 将 使 列表 项 以 单 选 按钮 列表 形式 显示 (如 图 4-19 所 示 )。 


第 4 章 ”使 用 视图 设计 用 户 界面 


m. 5554 Android 2.2 Emulator 


Dwight D. Eisenhower 


Jahn F. Kennedy 


Lyndon B. Johnson 


Richard Mixon 


Gerald Ford 


linm I Ter 


图 4-19 


4.4 ”本 草 小 结 


本 章 对 在 Android 应 用 程序 中 经 常会 用 到 的 一 些 视图 作 了 概述 。 虽 然 不 可 能 详细 研究 每 一 个 
视图 ， 但 这 里 所 学 习 到 的 视图 会 为 设计 Android 应 用 程序 的 用 户 界 面 提供 一 个 良好 的 基础 ， 而 不 
用 管 其 需求 是 什么 。 


1. ”如 何以 编程 万 式 来 确定 一 个 RadioButton 是 否 馈 选中 ? 
2. ”如 何 访问 存储 在 strings.xml 文 件 中 的 字符 串 资源 ? 
3. ”与 一 段 代 码 来 获取 当前 日 期 。 


练习 答案 参见 附录 C。 


to m 关键 概念 


«TextView 
android:layout width-"fill parent" 
lextView android:layout height-"wrap content" 
android:text-"8string/hello" 
/> 
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ils: 关键 概念 


«Button android:id="@+id/btnSave" 


android:layout width-"fill parent" 


Button | 
android:layout height-"wrap content" 
android:text-"Save" /> 

«ImageButton android:id-"Q-c-id/btnImgl" 
android:layout width-"fill parent" 

ImageButton youc 一 


android:layout height-"wrap content" 


android:src-"G8drawable/icon" /> 


«EditText android:id-"Qcid/txtName" 
EditText android:layout width-"fill parent" 


android:layout height-"wrap content" /> 


«CheckBox android:id-"8-cid/chkAutosave" 
android:layout width-"fill parent" 
CheckBox i — -P 


android:layout height-"wrap content" 


android:text-"Autosave" /» 


«RadioGroup android:id-"(vid/rdbGpl" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"vertical" > 
«RadioButton android:id-"Q8-id/rdbl" 

android:layout width-"fill parent" 

RadioGroup 和 RadioButton android:layout height-"wrap content" 

android:text-"Option 1" /» 
«RadioButton android:id-2"Q-rid/rdb2" 

android:layout width-"fill parent" 

android:layout height-"wrap content" 

android:text-"Option 2" /> 
«/RadioGroup» 


«ToggleButton android:id-"8-cid/togglel" 
ToggleButton android:layout width-"wrap content" 


android:layout height-"wrap content" /» 


«ProgressBar android:id-"8-c-id/progressbar" 
ProgressBar android:layout width-"wrap content" 
android:layout height-"wrap content" /> 


«AutoCompleteTextView android:id-"Q8-cid/txtCountries" 
AutoCompleteTextBox android:layout width-"fill parent" 


android:layout height-"wrap content" /> 


«TimePicker android:id-"8-cid/timePicker" 
TimePicker android:layout width-"wrap content" 


android:layout height-"wrap content" /» 
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to od 关键 概念 


«DatePicker android:id-"8-cid/datePicker" 
DatePicker android:layout width-"wrap content" 


android:layout height-"wrap content" 


«Spinner android:id-"Q-cid/spinnerl" 
- android:layout width-"wrap content" 
Spinner . BEN - 
android:layout height-"wrap content" 


android:drawSelectorOnTop-"true" /> 


使 用 视图 设计 用 户 界 面 


/> 
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使 用 视图 显示 图 片 和 菜单 


本 章 将 介绍 以 下 内 容 
e ”如何 使 用 Gallery、ImageSwitcher、GridView 和 ImageView 视 图 显示 图 像 
e ”如 何 显示 选项 菜单 和 上 下 文 菜单 
e ”如何 使 用 AnalogClock 和 DisitalClock 视 图 显示 时 间 
如 何 使 用 WebView 显 示 Web 内 容 

在 第 4 章 中 ， 我 们 已 经 学 习 了 可 以 用 来 构建 Android 应 用 程序 的 用 户 界 面 的 不 同 视图 。 本 章 
将 继续 研究 其 他 可 用 来 创建 健壮 的 、 吸 引 和 人 人 的 应 用 程序 的 视图 。 

特别 是 ， 我 们 会 将 注意 力 转 a 到 可 以 用 来 显示 图 像 的 视图 上 上。 此外， 还 将 学 习 如 何在 Android 
应 用 程序 中 创建 选项 和 上 下 文 荣 单 。 本 章 结束 时 将 讨论 一 些 可 用 来 显示 当前 时 间 和 Web 内 容 的 
ARABES EIS LET 


5.1 [£53 EE TRE FT 


到 目前 为 止 ， 我 们 已 经 学 习 的 所 有 视图 都 是 用 来 显示 文本 信息 的 。 要 显示 图 像 ， 可 以 使 用 
ImageView、Gallery、ImageSwitcher 和 GridView 视图 。 下 向 将 详细 介绍 每 一 个 视图 。 


5.1.1 Gallery 和 ImageView 视 图 


Gallery 古 一 种 用 固定 在 中 同位 置 的 水 平 深 动 列表 显示 列表 项 (如 图 像 ) 的 视图 。 图 5-1 展 示 了 
Gallery 视 图 在 显示 一 些 图 像 时 的 外 观 效果 : 


图 5-1 
下 面 的 “ 试 一 试 ” 展 示 了 如 何 使 用 Gallery 视 图 显示 一 组 图 像 。 


使 用 Gallery 视 图 


MiB er 


| 88] Mew Android Project 


Hew Android Project 


Creates a new Android Project resource, 


Project name: Gallery 
Contents 
(à Create new project in werkzpace 
(^) Create praject from existing source 
(9| Use default location 
Location: Cr Users Wei - Meng Leer mynewwo rkspace/ 6 al lery 
(C) Create project from existing sample 


Samples: | AccelerometerPlay 


Build Target 


Target Narne Vendor 

[^| Android 2.1-upda.. Android Open Source Project 
[^ Google APIs GoogleInc. 

[7| Android 2.2 Android Open Source Project 
E| Google APIs Google Inec. 

[7| GALAXY Tab Add.. Samsung Electronics Co., Ltd. 
[7| Android 2.3 Android Open Source Project 
[^| Google APIs Google Inc. 


Standard Android platform 2.5 


Properties 


Application name: Gallery 


Package name: net.Iearn? develop.Gallery 
Create Activity; — MainActivity 
Min SOR Versio: 9 


(2) 按照 下 列 粗 体 显示 内 容 修 改 main.xml 文 件 : 


«?xml version-"1.0" encoding-"utf-8"?- 


第 5 章 ”使 用 视图 显示 图 片 和 菜单 


Gallery.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 如 图 5-2 所 示 创 建 一 个 新 的 Android 项 目 。 


Platform 
Z21l-upd... 
21-upd... 
22 

22 

22 

23 

23 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:orientation-^"vertical" 


android:layout width-"fill parent" 


android:layout height-"ftill parent" > 


c«TextView 


android:layout width-"fill parent" 


android:layout height-"wrap content" 


android:text-"Images of San Francisco" /» 


«Gallery 


android:id-"(ü(tid/galleryl" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 
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«ImageView 
android:id="@+id/imagel" 
android:layout width-"320px" 
android:layout height-"250px" 
android:scaleType-"fitXY" /» 


«/LinearLayout» 


(3) 右 击 res/values 文 件 来， 选择 New | File， 并 将 新 文件 命名 为 attrs.xml。 
(4) 在 attrs.xml 文 件 中 输入 如 下 内 容 : 


«?xml version-"1.0" encoding-"utf-8"?» 
«resources» 
«declare-styleable name-"Galleryl"» 
<attr name-"android:galleryltemBackground" /> 
«/declare-styleable» 


«/resources» 


(5) 准备 一 组 图 像 ， 并 将 每 一 张 鲜 像 依次 命名 为 picl1.png、Ppic2.png 等 。 


FER. 可 以 从 本 书 的 支持 网 站 www.wfrox.com 上 下 载 这 组 图 像 。 


(6) 将 所 有 图 像 拖 放 到 res/drawable-mdpi 文 件 夹 下 (如 图 5-4 所 示 )。 当 显示 一 个 对 话 框 时 ， 选 
中 复制 选项 并 单 击 OK 按钮 。 


) ”注意 : 本 例 中 假设 这 一 项 目 将 在 具有 中 等 DPI 屏幕 分 辨 率 的 AVD 上 进行 测 
试 。 在 实际 的 项 目 中 ， 需 要 确保 每 一 个 drawable 文 件 夹 都 有 一 组 (不 同 分 辨 率 的 ) 


4 E» res 
b & drawable-hdpi 
E REPE. aaa d > (£» drawable-ldpi 
aa he 4 (z drawable-mdpi 


Wl icon.png 
[Bs picl.png 
|M] pic2.png 
[Bs pic3.png, 
picb.png LL pic4.png 
[Rs] pic5.png. 
(R| pic6.png| 
[Rs] pic7.png 
4 [— layout 
用 main.xml 
4 [— values 


pic/.png 


图 5-3 图 5-4 
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(7) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Gallery; 


import 


import 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


android 


android. 


android. 
android. 
android. 
android. 


android 
android 
android 


android. 
android. 
android. 


.app.AcLivitiy; 


.Widget. 
.widget. 
.Widget. 
widget. 
widget. 
widget. 


os.Bundle; 


content.Context; 
content.res.TypedArray; 
view.View; 


view.ViewGroup; 


AdapterView; 
AdapterView.OnItemClickListener; 
BaseAdapter; 

Gallery; 

ImageView; 


Toast; 


class MainActivity extends Activity I 


//--- 要 显示 的 图 像 --- 
Integer[] imageIDs = { 


P 


R.drawable.picl, 
.drawable.pic2, 
.drawable.pic3, 
.drawable.pic4, 
.drawable.picb5, 
.drawable.picó, 


VJ Ww Ww o mW su 


.drawable.pic?7 


/[** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


AOverride 


public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstancesState); 


setContentView(R.layout.main); 


Gallery gallery = (Gallery) findViewById(R.id.galleryl); 


gallery.setAdapter(new ImageAdapter(this)); 
gallery.setOnltemClickListener(new OnlItemClickListener() 
{ 
public void onItemClick(AdapterView«c?» parent, View v, 
int position, long id) 
t 
Toast.makeText(getBaseContext(), 
"pic" + (position + 1) + " selected", 
Toast.LENGTH SHORT).show(); 


)); 
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public class ImageAdapter extends BaseAdapter 


i 

private Context context; 

private int itemBackground; 

public ImageAdapter (Context c) 

{ 
context = c; 
/ / - - -i& Xe EX --- 
TypedArray a = obtainStyledAttributes (R.styleable.Gallery1); 
itemBackground = a.getResourceId( 

R.styleable.Galleryl android galleryltemBackground, 0); 

a.recycle(); 

} 

//--- 返 回 图 像 数 --- 

public int getCount() { 
return imageIDs.length; 

] 

//--- 返 回 一 个 项 的 ID--- 

public Object getItem(int position) { 
return position; 

] 

//--- 返 回 一 个 项 的 ID--- 

public long getlItemId(int position) | 
return position; 

} 

//--- 返 回 一 个 ImageView 视 图 --- 

public View getView(int position, View convertView, ViewGroup parent) ( 
ImageView imageView = new ImageView(context); 
imageView.setlImageResource(imageIDs[position]); 
imageView.setScaleType(ImageView.ScaleType.FIT XY); 
imageView.setLayoutParams (new Gallery.LayoutParams (150, 120)); 
imageView.setBackgroundResource (itemBackground); 
return imageView; 

] 

) 


(8) 按 Fl1 键 在 Android 模 拟 嚣 上 调试 应 用 程序 。 图 5-5 展 示 了 显示 一 系列 图 像 的 Gallery 视 图 。 
(9) 可 以 轻 扫 图 像 来 显示 整个 系列 的 图 像 。 单 击 一 个 图 像 时 可 以 观察 到 Toast 类 将 显示 图 像 名 
称 ( 如 图 5$-6 所 示 )。 
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m 5554Android 2.2 Emulator 


 Rerzallerw 


| Image 


hz isj|s]e|z |s |o ]o- 

Q |w je R |r v ju ]r fo le 

^ [s lo fe le |u |] [khi S 

Sic i-e hows e 
@ / 


5-5 
d 5554 Android 2.2 Emulator 


ERI] G3 3:08 pm 


o —1 


a |2 |a [a [s Je] |s |o lo 
ic5 selected o |w le Ir |r |Y |u [1 [o fe 
; a |s Jo F le |n |) |k |. I&i 
会 zx |c lv [e |In h|. Je 
golu aa i or al 

图 5-6 
(10) 为 了 在 ImageView 中 显示 所 选择 的 图 像 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 


语句 : 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 
Gallery gallery = (Gallery) findViewById(R.id.galleryl); 


gallery.setAdapter(new ImageAdapter (this)); 


15/ 
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gallery.setoOnrItemClickListener (new OnlItemClickListener (1) 


{ 


public void onltemClick (AdapterView<?> parent, View Vv, 
int position, long id) 


{ 
Toast.makeText(getBaseContext (), 


"pic" + (position + 1) + " selected", 
Toast.LENGTH SHORT).show(); 


//--- 显 示 选 择 的 图 像 --- 
ImageView imageView = (ImageView) findViewById(R.id.imagel) ; 
imageView.setlmageResource (imagelDs[position]); 


}); 
} 


(11) 按 F11 键 再 次 调试 应 用 程序 。 这 一 次 ， 将 会 看 到 在 ImageView 中 显示 了 所 选择 的 图 像 (如 
图 5-7 所 示 )。 
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图 5-7 


示例 说 明 
首先 将 Gallery 和 JImasgeView 视 图 添加 到 main.xml 文 件 中 : 


«Gallery 
android:id-"Q-crid/galleryl" 
android:layout width-"fill parent" 


android:layout height-"wrap content" /» 


«ImageView 
android:id-z"Q8-c-id/imagel" 
android:layout width-"320px" 
android:layout height-"250px" 
android:scaleType-"fitXY" /» 
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正如 先前 所 述 ，Gallery 视 图 用 来 在 一 个 水 平 深 动 列表 中 显示 一 系列 图 像 。ImageView 用 来 显 


示 用 户 选 定 的 图 像 。 


青 要 显示 的 图 像 列 表 存 储 在 imageIDs 数 组 中 : 


//--- 要 显示 的 图 像 --- 


Integer [|] 


R. 


R 
R 
R 
R 
R 
R 


He 


imageIDs = | 


drawable.picl, 


.drawable.pic2, 
-drawable.pic3, 
.drawable.pic4, 
.drawable.pico5, 
-drawable.piceo, 


.-drawable.pic/ 


创建 的 ImageAdapter 类 扩展 了 BaseAdapter 类 ， 可 以 用 来 将 一 系列 ImasgeView 视 图 绑 定 到 


Gallery fl Él E: 


Gallery gallery = (Gallery) findViewById(R.id.galleryl); 


gallery.setAdapter(new ImageAdapter (this)); 


gallery.setOnItemClickListener(new OnItemClickListener () 


Í 


public void onlItemClick(AdapterView«c?» parent, View v, 


int position, 


{ 


H? 


Toast.makeText(getBaseContext (), 


pic 


//--- 显 示 选 择 的 图 像 --- 


long id) 


" + (position + 1) + " selected", 
Toast.LENGTH SHORT).show(); 


ImageView imageView = (ImageView) findViewById (R.id.imagel); 


imageView.setlImageResource (imageIDs[position]); 


当选 定 ( 也 即 单 击 )Gallery 视 图 中 的 一 张 图 像 时 ， 将 显示 出 所 选 定 图 像 的 位 置 (第 一 张 图 像 是 


0， 第 二 张 图 像 是 1， 依 次 类 推 ) 并 在 ImageView 中 显示 此 图 像 。 


5.1.2 ImageSwitcher 


前 和 耐 一 广 演示 了 如 何 将 Gallery 视 图 与 一 个 ImageView 视 图 一 起 使 用 来 显示 一 系列 缩 略 图 像 ， 
以 便当 其 中 之 一 被 选中 时 ， 选 定 的 图 像 在 ImageView 中 显示 。 然 而， 有 时 您 并 不 想 当 用 户 在 
Gallery 视 图 中 选择 一 张 图 像 时 该 图 像 显 示 得 太 突 然 一 一 例如 ， 您 也 许 希 望 在 图 像 之 间 进 行 过 小 
时 应 用 一 些 动 画 效 果 。 这 时 ，Gallery 视 图 就 需要 ImageSwitcher 来 配合 使 用 。 下 和 面 的 “ 试 一 试 ” 


展示 了 使 用 方法 。 
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使 用 ImageSwitcher 视 图 
ImageSwitcher.zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 InageSwitcher 的 Android 项 目 。 
(2) 修改 main.xzml 文 件 ， 添 加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding-"utf-8"?- 
«RelativeLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:background-"£fff000000" > 


«Gallery 
android:id-"((*id/galleryl" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 


«ImageSwitcher 
android:id-"(ü(-id/switcherl" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout alignParentLeft-'"true" 
android:layout alignParentRight-"true" 


android:layout alignParentBottom-"true" /> 


</RelativeLayout> 


(3) 右 击 res/values 文 件 夹 ， 选 择 New | File， 并 将 文件 命名 为 attrs.xml。 
(4) 在 attrs.xml 文 件 中 输入 如 下 内 容 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 
«declare-styleable name-"Galleryl"» 
<attr name-"android:galleryIltemBackground" /> 
«/declare-styleable» 


«/resources» 
(5) 将 一 组 图 像 拖 放 到 res/drawable-mdpi 文 件 夹 下。 当 显 示 一 个 对 话 框 时 ， 选 中 复制 选项 并 单 
击 OK 按 钮 。 
(6) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
package net.learn2develop.ImageSwitcher; 


import android.app.Activity; 


import android.os.Bundle; 


import android.content.Context; 
import android.content.res.TypedArray; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 


第 5 章 


view.View; 


view.ViewGroup; 


view.ViewGroup.LayoutParams; 


view.animation.AnimationUtils; 


widget. 
widget. 
widget. 
widget. 
widget. 
widget. 
widget. 


BaseAdapter; 

AdapterView; 
AdapterView.OnItemClickListener; 
Gallery; 
ViewSwitcher.ViewFactory; 
ImageSwitcher; 

ImageView; 


使 用 视图 显示 图 片 和 菜单 


public class MainActivity extends Activity implements ViewFactory { 


//--- 要 显示 的 图 像 --- 


Integqer[] 


I 


R. 


JJ o wo mw 


imageIDs 


zd 


drawable.picl, 
.drawable.pic2, 
.drawable.pic3, 
.drawable.pic4, 
.drawable.picb, 
.drawable.picó, 
.drawable.pic?7 


private ImageSwitcher imageSwitcher; 


/[** 当 活 动 第 一 次 被 创建 时 调用 。 


(Override 


i 


public void onCreate(Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


imageSwitcher 


imageSwitcher.setFactory(this); 
imageSwitcher.setInAnimation (AnimationUtils.loadAnimation(this, 
android.R.anim.fade in)); 
imageSwitcher.setOutAnimation (AnimationUtils.loadAnimation(this, 


android.R.anim.fade out)); 


(ImageSwitcher) findViewByIld (R.id.switcherl); 


Gallery gallery = (Gallery) findViewById(R.id.galleryl); 
gallery.setAdapter(new ImageAdapter(this)); 
gallery.setOnltemClickListener(new OnlItemClickListener() 


{ 


public void onlItemClick(AdapterView«? parent, 


View v, 


{ 


}); 


int position, 


long id) 


imageSwitcher .setImageResource (imageIDs [position]); 
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public View makeView() 


| 


ImageView imageView = new ImageView (this); 
imageView.setBackgroundColor (O0xFF000000); 
imageView.setScaleType(ImageView.ScaleType.FIT CENTER); 
imageView.setLayoutParams (new 
ImageSwitcher.LayoutParams ( 
LayoutParams.FILL PARENT, 
LayoutParams.FILL PARENT)); 


return imageView; 


public class ImageAdapter extends BaseAdapter 


| 


private Context context; 


private int itemBackground; 


public ImageAdapter (Context c) 
{ 


context = c; 


//--- 设 定 样式 --- 

TypedArray a = obtainStyledAttributes (R.styleable.Galleryl1); 

itemBackground = a.getResourceId( 
R.styleable.Galleryl android galleryItemBackground, 0); 

a.recycle(); 


//--- 返 回 图 像 数 --- 
public int getCount() 
{ 


return imageIDs.length; 


//--- 返 回 一 个 项 的 ID--- 
public Object getlItem(int position) 
{ 


return position; 


public long getlItemId(int position) 
{ 


return position; 


//--- 返 回 一 个 ImageView 视 图 --- 
public View getView(int position, View convertView, ViewGroup parent) 
{ 


ImageView imageView = new ImageView (context); 
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imageView.setlmageResource (imageIDs[position]); 
imageView.setScaleType (ImageView.ScaleType.FIT XY); 
imageView.setLayoutParams (new Gallery.LayoutParams (150, 120)); 
imageView.setBackgroundResource (itemBackground); 


return imageView; 


(7) 按 F11 键 在 Android 横 拟 右 上 调试 应 用 程序 。 图 5$-8 展 示 了 Gallery 和 JImageSwitcher 视 疼 ， 
有 两 个 图 像 集合 以 及 选 定 的 图 像 。 
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示例 说 明 

在 这 个 示例 中 ， 首 先 需 要 注意 的 是 MainActivity 不 但 扩展 了 Activity， 而 且 还 实现 了 
ViewFactory。 为 了 使 用 ImageSwitcher 视 图 ， 需 要 实现 ViewFactory 接 口 ， 它 创建 了 可 与 
ImageSwitcher 视 图 一 起 使 用 的 视图 。 因 此 ， 需 要 实 坝 makeView() 方 法 : 


public View makeView() 
{ 
ImageView imageView — new ImageView(this); 
imageView.setBackgroundColor(O0xFF000000); 
imageView.setScaleType(lImageView.ScaleType.FIT CENTER); 
imageView.setLayoutParams (new 
ImageSwitcher.LayoutParamsf( 
LayoutParams.FILL PARENT, 
LayoutParams.FILL PARENT)); 
return imageView; 


} 
这 个 方法 创建 一 个 新 的 View 来 洪 加 人 到 ImageSwitcher 视 图 中 。 
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SLE B — n HgGalleryzn Pl, mi 22 5:3 — ^ ImageAdapter2S?K 4 — £& /ilImageView Hl d 5p xz F] 
Gallery 视 图 上 。 

在 onCreate(0) 方 法 中 ， 可 以 获得 对 ImageSwitcher 视 图 的 引用 并 设置 动画 ， 指 定 图 像 应 该 如 何 

“ 飞 入 ”和 “ 飞 出 ”视图 。 最 后 ， 当 在 Gallery 视 图 中 选 定 一 张 图 像 时 ， 它 它 将 在 ImageSwitcher 视 
图 中 显示 出 来 : 


QOverride 
public void onCreate(Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


imageSwitcher = (ImageSwitcher) findViewById(R.id.switcherl); 

imageSwitcher.setFactory(this); 

imageSwitcher.setInAnimation (AnimationUtils.JoadAnimation(this, 
android.R.anim.fade in)); 

imageSwitcher.setOutAnimation (AnimationUtils.l/oadAnimation (this, 


android.R.anim.fade out)); 


Gallery gallery = (Gallery) findViewById(R.id.galleryl); 
gallery.setAdapter(new ImageAdapter (this)); 


gallery.setOnItemClickListener(new OnItemClickListener () 


{ 
public void onItemClick(AdapterView<?> parent, 
View v, int position, long id) 
{ 
imageSwitcher.setIlImageResource (imageIDs[position]); 
} 
}); 


本 例 中 ， 当 在 Gallery 视 图 中 选 定 一 个 图 像 时 ， 它 将 以 “ 淡 入 ”的 方式 显示 出 来 。 当 选 定 下 
一 个 图 像 时 ， 当 前 图 像 将 汉 出 。 如 果 想 让 图 像 从 左边 滑 入 ， 而 在 选择 另 一 幅 图 像 时 册 从 右边 滑 
出 ， 可 竹 试 下 和 面 的 动画 效果 : 

imageSwitcher.setInAnimation(AnimationUtils.loadAnimation(this, 
android.R.anim.slide in left)); 
imageSwitcher.setOutAnimation(AnimationUtils.loadAnimation (this, 


android.R.anim.slide out right)); 


和 前 面 的 “ 试 一 试 ” 一 样 ， 仍 旧 通 过 扩展 BaseAdapter 类 来 创建 ImageAdapter 类 ， 以 便 将 一 
系列 ImageView 视 图 绑 定 到 Gallery 视 图 上 。 


5.1.3 GridView 


GridView 在 一 个 二 维 的 滚动 网 格 中 来 显示 项 。 TN 了 一 个 ImageView 配 合 使 用 来 
显示 一 系列 图 像 。 下 面 的 “ 试 一 试 ” 展 示 了 如 何 做 到 这 一 点 。 


使 用 GridView 视 图 


(1) 打开 Eclipse， 创 建 一 个 名 为 Grid 的 Android 项 目 。 

(2) 将 一 组 图 像 拖 放 到 res/drawable-mdpi 文 件 夹 下 (如 
不 )。 当 显示 一 个 对 话 框 时 ， 选 中 复制 选项 并 单 击 OK 按钮 。 

(3) 在 main.xml 文 件 中 输入 以 下 内 容 : 


<?xml version-"1.0" encoding-"utf-8"?- 
«GridView xmlns:android-"http://schemas.android. 


com/apk/res/android" 


android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


/? 


id-z"(trid/gridview" 

layout width-"fill parent" 
layout height-"fill parent" 
numColumns-"auto fit" 


verticalSpacing-"1l0dp" 


85m “使 用 视图 显示 图 片 和 菜单 


Grid.zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


4 i res 
b [£» drawable-hdpi 
b & drawable-lIdpi 
4 (SS drawable-mdpi 
Wy icon.png 
(m| picl.png 
[m] pic2.png 


图 5-9 所 


(| pic3.png 

(m| picd.png 

| pic5.png 

(R| pic6.png 

[Rs] pic7.png 
4 [— layout 

| 用 main.xml 


图 5-9 


horizontalSpacing-"10dp" 
columnWidth-"90dp" 
stretchMode-"columnWidth" 


gravity-"center" 


(4) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Grid; 


import 


import 


import 
import 
import 
import 
import 
import 
import 
import 
import 


android. 


android. 


android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 


app-Activity; 


os.Bundle; 


content.Context; 


view.View; 


view.ViewGroup; 


widget 
widget 
widget 
widget 
widget 
widget 


.AdapterView; 
.AdapterView.OnlItemClickListener; 
.BaseAdapter; 

.GridView; 

.lmageView; 


.Toast; 


public class MainActivity extends Activity I 
//--- 要 显示 的 图 像 --- 
Integer[] 


R. 


Jo mW wm 


imageIDs 
drawable 
.drawable 
.drawable.pic3, 


.piocl, 
.pic2, 


.drawable.pic4, 
.drawable.picb5, 
.drawable.picó, 
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R.drawable.pic?7 


F: 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 


public void onCreate (Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


GridView gridView = (GridView) fidViewById(R.id.gridview); 
gridView.setAdapter(new ImageAdapter (this)); 


gridView.setOnlItemClickListener(new OnItemClickListener () 
{ 
public void onltemClick (AdapterView<?> parent, 


View v, int position, long id) 


{ 
Toast.makeText(getBaseContext(), 
"pic" + (position + 1) + " selected", 
Toast.LENGTH SHORT).show(); 
} 


H; 


public class ImageAdapter extends BaseAdapter 


{ 


private Context context; 


public ImageAdapter (Context c) 


{ 

context = c; 
} 
//--- 返 回 图 像 数 --- 


public int getCount() ( 


return imageIDs.length; 


//--- 返 回 一 个 项 的 ID--- 
public Object getlItem(int position) { 
return position; 


// ---iB [EI —  RÉJID--- 
public long getlItemId(int position) { 


return position; 


//--- 返 回 一 个 ImageView 视 图 --- 
public View getView(int position, View convertView, 


第 5 章 ”使 用 视图 显示 图 片 和 菜单 


ViewGroup parent) 


{ 
ImageView imageView; 
if (convertView == null) I 
imageView = new ImageView(context); 
imageView.setLayoutParams (new 
GridView.LayoutParams (85, 85)); 
imageView.setScaleType( 
lImageView.ScaleType.CENTER CROP); 
imageView.setPadding(5, 5, 5, 5); 
} else I 
imageView = (ImageView) convertView; 
} 
imageView.setlmageResource(imageIDs[position]); 
return imageView; 
] 


(5) 按 F1l1 键 在 Android 模 拟 絮 中 调试 应 用 程序 。 图 5-10 展 示 了 显示 所 有 图 像 的 GridView。 


前 5554:Android_2.2_Emulator 


ERAN A 4:21 pw 


PIC5 selected 


-= 
三 一 一 一 一 六 一 


图 5-10 
示例 说 明 
与 Gallery 和 ImageSwitcher 示 例 一 样 ， 实 现 ImageAdapter 类 并 绑 定 到 GridView: 


GridView gridView = (GridView) findViewById(R.id.gridview); 
gridView.setAdapter(new ImageAdapter (this)); 


gridView.setOnlItemClickListener(new OnItemClickListener() 


Í 
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public void onlItemClick(AdapterViewc?» parent, 


View v, int position, long id) 


{ 
Toast.makeText(getBaseContext (), 
"Hic" + (position + 1) + T Selected", 
Toast.LENGTH SHORT).show(); 
} 


}); 


当选 择 了 一 个 图 像 时 ， 将 显示 一 个 Toast 消 恩 表 明 该 图 像 已 被 选 定 。 
在 GridView 中 ， 可 以 指定 图 像 的 大 小 ， 并 通过 为 每 幅 图 像 设 置 内 边 距 在 GridView 中 对 图 像 
进行 分 隔 : 


/ /一 -返回 一 个 ImageView 视 图 一 一 一 
public View getView(int position, View convertView, 


ViewGroup parent) 


{ 
ImageView imageView; 
if (convertView == null) { 
imageView — new ImageView(context); 
imageView.setLayoutParams (new 
GridView.LayoutParams (85, 85)); 
imageView.setScaleType( 
ImageView.ScaleType.CENTER CROP); 
imageView.setPadding(5, 5, 5, D); 
] else | 
imageView — (ImageView) convertView; 
} 
jmageView.setlImageResource (1ImageIDs [position]);} 
return imageView; 
} 
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@ 上 下 文 菜 单一 一 显示 和 活动 中 一 个 特定 的 视图 相关 的 信息 。 在 Android 中 ， 通 过 单 击 并 按 住 
视图 来 激活 上 下 文 菜单 。 
图 5-11 展 示 了 浏览 器 应 用 程序 中 的 一 个 选项 染 单 的 示例 。 当 用 户 按 下 MENU 按 钮 时 ， 选 项 
菜单 将 显示 出 来 。 所 显示 的 菜单 项 随 当 前 正在 运行 的 活动 而 各 寞 。 
图 5-12 展 示 了 当 用 户 按 下 并 保持 在 页 面 上 的 一 个 超 链接 时 所 显示 的 上 下 文 菜单 。 显 示 的 菜 
单项 随 当 前 选 定 的 组 件 或 视图 而 各 异 。 为 了 激活 上 下 文 沫 单 ， 用 户 可 在 屏 医 上 选择 一 项 ， 单 击 
并 按 住 它 ， 或 者 直接 按 方 同 键 盘 上 的 中 间 按 钮 。 


显示 和 当前 活动 相关 的 信息 。 在 Android 中 ， 通 过 按 下 MENU 键 来 激活 选项 
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5.2.1 创建 辅助 方法 


在 深入 学 习 和 创建 选项 菜单 以 及 上 下 文 末 单 之 前 ， 壳 要 创建 两 个 辅助 方法 。 一 个 创建 将 在 
末 单 内 显示 的 项 列表 ， 男 一 个 处 理 用 户 在 六 单 内 选 定 一 项 时 所 触发 的 事件 。 


创建 菜单 辅助 方法 


Menus.zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 Menus 的 Android 项 目 。 
(2) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Menus; 


import android.app.Activity; 


import android.os.Bundle; 


import android.view.Menu; 

import android.view.Menultem; 
import android.widget.Button; 
import android.widget.Toast; 


public class MainActivity extends Activity I 
/[** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
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setContentView(R.layout.main); 


private void 


{ 


CreateMenu (Menu menu) 


Menultem mnul = menu.add(0, O0, O0, "Item 1"); 
{ 
mnul.setAlphabeticShortcut('a'); 
mnul.setlIcon(R.drawable.icon); 
] 
Menultem mnu2 = menu.add(0, 1, 1, "Item 2"); 
{ 
mnu2.setAlphabeticShortcut('b'); 
mnu2.setlIcon(R.drawable.icon); 
] 
Menultem mnu3 = menu.add(0, 2, 2, "Item 3"); 
{ 
mnu3.setAlphabeticShortcut('c'); 
mnu3.setIlIcon(R.drawable.icon); 
] 
Menultem mnu4 = menu.add(0, 3, 3, "Item 4"); 
{ 
mnu4 . setAlphabeticShortceut('d'); 
} 


menu.add(0, 3, 3, "Item 5"); 
menu.add(0, 3, 3, "Item 6"); 
menu.add(0, 3, 3, "Item 7"); 


private boolean MenuChoice (MenuItem item) 
{ 
switch (item.getIlItemId()) ( 
case 0: 
Toast.makeText(this, "You clicked on Item 
Toast.LENGTH LONG).show(); 
return true; 
case 1: 
Toast.makeText(this, "You clicked on Item 
Toast.LENGTH LONG).show(); 
return true; 
case 2: 
Toast.makeText(this, "You clicked on Item 
Toast.LENGTH LONG).show(); 
return true; 
case 3: 
Toast.makeText(this, "You clicked on Item 
Toast.LENGTH LONG).show(); 
return true; 
case 4: 
Toast.makeText(this, "You clicked on Item 
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Toast.LENGTH LONG) .show(); 
return true; 
case 5: 
Toast.makeText(this, "You clicked on Item 6", 
Toast.LENGTH LONG).show(); 
return true; 
case 6: 
Toast.makeText(this, "You clicked on Item 7", 
Toast.LENGTH LONG).show(); 
return true; 
] 


return false; 


示例 说 明 


前 和 面 的 示例 创建 了 两 个 方法 : CreateMenu(0) 和 MenuChoice(0) 。CreatMenu() 方 法 接受 一 个 
Menu 参 数 并 同 其 添加 一 系列 菜单 项 。 
为 了 回 全 单 中 添加 集 单 项， 需要 创建 一 个 MenuItem 关 的 实例 并 使 用 Menu 对 象 的 add0 方 法 。 
Menultem mnul = menu.add(0, 0, 0, "Item 1"); 
| 
mnul.setAlphabeticShortcut('a'); 


mnul.setlIcon(R.drawable.icon); 


} 


add() 方 法 的 4 个 参数 如 下 所 示 : 
@ srouId 一 一 菜单 项 所 在 的 组 的 标识 符 ， 使 用 0 表示 一 个 菜单 项 不 在 一 个 组 中 
€ itemId 一 一 唯一 的 菜单 项 ID 


€ order 菜单 项 显示 的 顺序 
e title 一 一 蘑 单 项 显示 的 文本 


可 以 使 用 setAlphabeticShortcut() 方 法 来 给 菜单 项 分 配 快捷 键 ， 这 样 用 户 可 以 通过 在 键盘 上 按 
键 来 选择 一 个 菜单 项 。setIcon0 方 法 设置 将 在 菜单 项 上 显示 的 图 像 。 

MenuChoice()j i $257 —^Menultem2 Zt, JF Ey £x KCIDOK fü c E "Pase rs AR, E 
显示 一 个 Toast 消 息 告 诉 用 户 哪 一 个 全 单项 被 单 击 了 。 


5.2.2 选项 菜单 
现在 准备 修改 应 用 程序 ， 使 得 当 用 户 在 Android 设 备 上 按 下 MENU 按 钮 时 显示 选项 菜单 。 


显示 选项 菜单 


(1) 使 用 前 一 节 所 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.Menus; 


import android.app.Activity; 
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import android.os.Bundle; 
import android.view.Menu; 
import android.view.MenuItem; 
import android.widget.Button; 


import android.widget.Toast; 


public class MainActivity extends Activity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


} 


Override 

public boolean onCreateOptionsMenu (Menu menu) { 
super.onCreateOptionsMenu (menu); 
CreateMenu (menu); 
return true; 


) 


QOverride 
public boolean onOptionsItemSelected (MenuItem item) 
i 

return MenuChoice(item); 


private void CreateMenu (Menu menu) 
{ 
Ifa: 


private boolean MenuChoice (MenuItem item) 
{ 
y M 


' 5554; Android 2.2 Emulator 


(2) 按 F11 键 在 Android 模 拟 


器 中 调试 应 用 程序 。 图 5$-13 展 d 

示 了 当 单 击 MENU 按 钮 时 所 弹 9 (= © 
出 的 选项 菜单 。 要 选择 一 个 菜 ©0009 
单项 ， 可 以 单 击 单独 的 全 单项 
或 者 使 用 其 快捷 键 (A 到 D; 只 5 [4.|s [s |z lanlen |o] 
对 前 4 个 菜单 项 有 效 )。 NL Mile CRURA FIER CHEN 


Wd 


Mare 
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示例 说 明 


为 了 显示 活动 的 选项 沫 单 ， 盐 要 在 活动 中 重 写 爽 个 方法 : onCreateOptionsMenu() 和 onOptions- 
ItemSelected()。 当 MENU 按 钮 被 按 下 时 调用 onCreateOptionsMenu() 方 法 。 在 这 一 事件 中 ， 调 用 
CreateMenu0 辅 助 方法 来 显示 选项 业 单 。 当 选择 了 一 个 菜单 项 时 ， 将 调用 onOptionsItemSelected() 方 
法 。 这 时 ， 调 用 MenuChoice() 方 法 来 显示 所 选择 的 亲 单 项 (并 做 任何 想 做 的 事 )。 

观察 为 菜单 项 1、2 和 3 所 显示 的 图 标 。 如 果 选 项 菜单 的 菜单 项 数目 超过 6 个 ， 将 会 显示 一 个 
More 沫 单项 来 表明 还 有 其 他 的 选项 。 图 5-14 展 示 了 在 用 户 按 下 Meore 染 单项 后 所 显示 的 一 个 额外 
菜单 项 的 列表 。 


D] 3334: Android 2.2 Emulator 


Tap and hald this for more options... 


5-14 


5.2.3 ”上下文 菜单 


前 一 节 讲 述 了 在 用 户 按 下 MENU 按 钮 时 是 如 何 显 示 选 项 菜单 的 。 除 了 选项 菜单 ， 还 可 以 显 
示 上 下 文 沫 单 。 上 下 文 沫 蛙 通 常 和 活动 上 的 一 个 视图 相关 联 ， 并 在 用 户 长 按 一 个 项 时 显示 。 例 
如 ， 如 果 用 户 按 住 Button 视 图 并 持续 几 秒 钟 ， 就 会 显示 一 个 上 下 文 玉 单 。 

如 果 打 算 将 上 下 文 菜 单 和 活动 上 的 一 个 视图 联系 起 来 ， 需 要 调用 那个 视图 的 
setOnCreateContextMenuListener() 方 法 。 下 和 而 的 “ 试 一 试 ” 展 示 了 如 何 使 一 个 上 下 文 菜 单 与 一 个 
Button 视 图 进行 天 联 。 


显示 上 下 文 菜单 


(1) 使 用 前 一 节 所 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
package net.learn2develop.Menus; 


import android.app.Activity; 
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import android.os.Bundle; 
import android.view.Menu; 
import android.view.MenuItem; 
import android.widget.Button; 


import android.widget.Toast; 


import android.view.View; 
import android.view.ContextMenu; 
import android.view.ContextMenu.ContextMenuInfo; 


public class MainActivity extends Activity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


Button btn = (Button) findViewById (R.id.btnl); 
btn.setOnCreateContextMenuListener(this); 


QOverride 

public boolean onCreateOptionsMenu(Menu menu) { 
super.onCreateOptionsMenu (menu) ; 
CreateMenu (menu); 


return true; 


QOverride 
public boolean onOptionsItemSelected (MenuIlItem item) 
i 


return MenuChoice (item); 


GOverride 

public void onCreateContextMenu(ContextMenu menu, View view, 
ContextMenuInfo menuInfo) 

i 


super.onCreateContextMenu (menu, view, menuInfo); 


CreateMenu (menu) ; 


Q&Override 
public boolean onContextlItemSelected (MenuItem item) 


{ 
return MenuChoice (item); 


private void CreateMenu (Menu menu) 


{ 
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s 


private boolean MenuChoice (Menultem item) 
{ 
a ET 


} 


(2) T&FITSEfEAndroidU gs ENHET KIS-152 J EK TaButton t RT TERE P 
XB. 


| & 353&Android 22 Emulator 


ere 
rjr] 

eleta 
s 
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示例 说 明 


在 上 述 示 例 中 ， 调 用 Button 视 图 的 setOnCreateContextMenuListener() 方 法 将 它 和 一 个 上 下 文 
菜单 建立 关联 。 

当 用 户 长 按 Button 视 图 时 ，onCreateContextMenu() 方 法 将 被 调用 。 在 这 一 方法 中 ， 通 过 
调用 CreateMenu() 方 法 来 显示 上 下 文 菜 单 。 类 似 地 ， 当 上 下 文 菜 单 内 的 一 个 项 被 选中 时 ， 
onContextItemSelected0) 方 法 将 被 调用 ， 在 其 中 调用 MenuChoice0) 方 法 来 癌 用 户 显示 一 条 消息 。 

注意 ， 于 单项 的 快捷 键 并 未 生效 。 要 使 之 生效 ， 需 要 调用 Menu 对 象 的 setQuertyMode() 方 
法 ， 如 下 所 示 : 


private void CreateMenu (Menu menu) 


1 
menu.setQwertyMode (true); 
Menultem mnul = menu.add(0, 0, 0, "Item 1"); 
{ 
mnul.setAlphabeticShortcut ('d'); 
mnul.setlIcon(R.drawable.icon); 
} 
TIT 
] 
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这 样 做 了 以 后 束 会 使 快捷 键 生效 (如 图 5-16 所 示 )。 


| S54Android 2.2. Emulator 


53 ”其 他 一 些 视图 


除了 目前 已 经 了 解 的 标准 视图 之 外 ，Android SDK 还 提供 了 其 他 一 些 可 使 应 用 程序 变 得 更 加 
ARERR. KEF, RIAA PWR: AnalogClock、DigitalClock 和 WebView。 


5.3.1 _ AnalogClock 和 DigitalClock 视 图 
AnalogClock 视 图 显示 一 个 有 两 根 指针 (一 根 分 针 ， 一 根 时 针 ) 的 模拟 时 钟 ， 而 DigitalClock 视 


图 以 数字 形式 显示 时 间 。 它 们 二 者 都 显示 的 是 系统 时 间 ， 不 允许 用 户 用 来 显示 一 个 特定 时 间 。 
因此 ， 如 宋 您 打算 显示 一 个 特定 区 域 的 时 间 ， 台 必须 构建 一 个 目 己 的 定制 视图 。 


Z 注意 : 在 Android 中 创建 一 个 自己 的 定制 视图 已 经 超出 了 本 书 的 范围 。 不 
^ 过， 如 果 您 对 这 一 领域 感 兴趣 ， 可 以 在 Google 的 Android 文 档 中 查看 这 一 主题 : 
http://developer.android.convguide/topics/ui/custom-components.html . 


使 用 AnalogClock 和 DigitalClock 视 图 是 很 简单 的 。 只 需要 在 XML 文 件 (例如 main.xml) 中 声明 


<?xml version-"1.0" encoding="utf—8"?> 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
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«AnalogClock 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 


«DigitalClock 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 


</LinearLayout> 


图 5-17 展 示 了 运用 中 的 AnalogClock 和 DigitalClock 视 图 。 


W S555dAndroid_2.2_Ernulator 


Ea a 后 2:22 AM 


5.3.2 WebView 


WebView n] LJ fi f8: YE 356 2] H BR N — 7 Web| à ga «— Al AR NV FH ER a € BRUN — EWeb pj 
| [他 一 些 提 供 商 的 地 图 等 一 一 这 个 视图 就 很 有 用 。 下 面 的 “ 试 一 试 ” 展 示 了 了 如何 
以 编程 方式 加 载 一 个 Web 页 和 面 的 内 容 并 在 活动 中 显示 出 来 。 


Zx 


使 用 WebView 视 图 


WebView.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 WebView 的 Android 新 项 目 。 
(2) 在 main.xml 文 件 中 添加 以 下 语句 : 


«?xml version-"1.0" encoding-"utf-8"?-» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 


android:layout height-"fill parent" 
> 
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<WebView android:id-"(üirid/webviewl" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 


</LinearLayout> 


(3) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.WebView; 


import android.app.Activity; 
import android.os.Bundle; 

import android.webkit.WebSettings; 
import android.webkit.WebView; 


public class MainActivity extends Activity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


WebView wv = (WebView) findViewById(R.id.webviewl); 

WebSettings webSettings - wv.getSettings(); 
webSettings.setBuiltlInZoomControls (true); 

wv.loadUrl( 

"http: //ecx.images-amazon.com/images/I/A41HGB-W2Z28L. SL500 AA300 .jpg"); 


(4) TZF118EZEAndroid dU 28 EUN HI RE. Kd5-18/i£zs f WebViewlf] JR. 
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示例 说 明 
为 了 利用 WebView 来 加 载 一 个 Web 页 面 ， 可 以 使 用 loadUrlO0 方 法 ， 如 下 所 未 : 


wv.loadUrl(í 
"http://ecx.images-amazon.com/images/I/41HGB-W2Z28L. SL500 AA300 .jpg"); 
要 显示 内 置 的 缩放 控件 ， 需 要 首先 从 WebView 中 获取 WebSettings 属 性 ， 然 后 调用 它 的 
setBuiltInZoomControls() 77 YA: 


WebSettings webSettings = wv.getSettings(); 


webSettings.setBuiltInZoomControls (true); 


图 5$-19 展 示 了 在 Android 模 拟 器 上 使 用 鼠标 单 击 并 拖 搜 WebView 内 容 时 显示 的 内 置 缩放 
控件 。 


» 注意 : 尽管 大 多 数 Android 设 备 支持 多 点 触摸 
屏幕 ， 但 当 在 Android 模 拟 器 上 测试 应 用 程序 时 ， 
可 以 使 用 内 置 的 缩放 控件 对 Web 内 容 进 行 缩放 。 


WebView 


^N. Uu—^ ex m o mi mr Op d Jn www.wrox. 
com 会 重 定向 到 www.wrox.com/wileyCDA)，WebView 将 导致 应 wu 
用 程序 启动 设备 的 浏览 器 应 用 程序 来 加 载 所 需 的 页 面 。 例 如 ， Beginning 


如 果 让 WebView 加 载 www.wrox.com，Wirox.com 将 上 月 动 重 定 回 Apolication De 


到 www.wrox.com/WileyCDA/。 这 时 ， 应 用 程序 将 日 动 局 动 设 (cwn mr 
AHA A s IN HUE Y ORO Vf. ÆRS-20F, EEE 
端的 URL 栏 。 
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H TERAPIER, m E KMWebViewClient}} 3€ shouldOverride UrlLoading() 77 
法 ， 如 下 面 的 示例 所 示 : 
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package net.learn2develop.WebView; 


import android.app.Activity; 

import android.os.Bundle; 

import android.webkit.WebSettings; 
import android.webkit.WebView; 
import android.webkit.WebViewClient; 


public class MainActivity extends Activity { 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


WebView wv — (WebView) findViewById(R.id.webviewl); 
wv.setWebViewClient(new Callback()); 

WebSettings webSettings = wv.getSettings(); 
webSettings.setBuiltInZoomControls (true); 


wv.loadUrl("http://www.wrox.com"); 


private class Callback extends WebViewClient { 
Override 
public boolean shouldOverrideUrlLoading (WebView view, String url) { 


return(false); 


图 5-21 展 示 了 现在 在 WebView 中 正确 加 载 了 Wrox.com 主 页 。 
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还 可 以 使 用 loadDataWithBaseURLO 方 法 动态 创建 一 个 HIML 字符 串 并 加 载 到 WebView 中 : 


第 5 章 “使 用 视图 显示 图 片 和 菜单 


WebView wv = (WebView) ftindViewById(R.id.webviewl); 


final String mimeType = "text/html"; 
final String encoding - "UTF-8"; 


String html = "«H1»A simple HTML pagec/Hl»«body»" + 
"<p>The quick brown fox jumps over the lazy dogc/p»"; 


wv.loadDataWithBaseURL("", html, mimeType, 


图 $-22 展 示 了 由 WebView 所 显示 的 内 容 。 


r1 


3534 ndroid 2.2 Emulator 


| A simple HTML 
page 


The quick brown fox jumps over the lazy 
dog 


329 


encoding, ""); 


P 


此 外 ， 如 果 在 assets 文 件 夹 下 有 一 个 HTML 文 件 ( 如 图 5-23 所 示 )， 还 可 以 使 用 loadUrl0) 方 法 将 
其 加 载 到 WebView 中 : 


WebView wv = (WebView) findViewById(R.id.webviewl); 
wv.loadUrl("file:///android asset/Index.html"); 


8 Java - WebView/assets/Indexhtml- Eclipse —— 
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图 5-24 展 示 了 WebView 的 内 容 。 
| '" 5554Andraid 2.2 Emulator 
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5.4 本章 小 结 


本 半 中 ， 我 们 学 习 了 可 用 来 显示 图 像 的 各 种 视图 : Gallery、ImageView、ImageSwitcher 和 
GridView。 此 外 ， 还 了 解 了 选项 菜单 和 上 下 文 沫 单 的 不 同 ， 以 及 如 何在 应 用 程序 中 显示 它们 。 
最 后 ， 我 们 还 学 习 了 AnalogClock 和 DigitalClock 视 图 (它们 以 图 形 化 的 方式 显示 当前 时 间 )， 以 及 
用 来 显示 Web 页 面 内 容 的 WebView 视 图 。 


ImageSwitcher 的 作用 是 什么 ? 

说 出 在 活动 中 实现 选项 菜单 时 需要 重 写 的 两 个 方法 。 

说 出 在 活动 中 实现 上 下 文 菜单 时 需要 重 写 的 两 个 方法 。 

当 在 WebView 中 发 生 重 定 同时 如 何 防止 其 启动 设备 的 Web 浏 览 器 ? 


练习 管 案 参 见 附录 C。 
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本 章 主 要 内 


tro m 关键 概念 
Gallery 视 图 的 使 用 ”在 水 平 滚动 列表 中 显示 一 系列 图 像 


«Gallery 
android:id-"8-c-id/galleryl" 


Gallery . | | 
android:layout width-"fill parent" 
android:layout height-"wrap content" i> 
<ImageView 
android:id="@+id/imagel" 
ImageView android:layout width="320px" 


android:layout height="250px" 
android:scaleType-"fitXY" /» 


ImageSwitcher 的 使 用 当 在 图 像 间 切 换 时 应 用 动画 效果 


«ImageSwitcher 
android:id-"Q-cid/switcherl" 
android:layout width-"fill parent" 
ImageSwitcher android:layout height-"fill parent" 
android:layout alignParentLeft-"true" 
android:layout alignParentRight-"true" 


android:layout alignParentBottom-"true" /» 
GridView 的 使 用 在 一 个 二 维 的 滚动 网 格 中 显示 项 


«GridView xmlns:android-"http://schemas.android.com/apk/res/android" 
android:id-"Q-rid/gridview" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 

GridView dc P a M cca Bb a d 
android:verticalSpacing-"lOdp" 
android:horizontalSpacing-"lOdp" 
android:columnWidth-"S90dp" 
android:stretchMode-"columnWidth" 


android:gravity-"center" /» 


«AnalogClock 
AnalogClock android:layout width-"wrap content" 


android:layout height-"wrap content" /> 
«DigitalClock 
DigitalClock android:layout width-"wrap content" 
android:layout height-"wrap content" f> 
<WebView android:id="@+id/webviewl" 
WebView android:layout width="wrap content" 


android:layout height="wrap content" /> 
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本 章 将 介绍 以 下 内 容 

e 如 何 使 用 SharedPreferences 对 象 保存 简单 数据 

e 如 何 写 入 和 读 取 内 部 和 外 部 存储 器 中 的 文件 

e 如 何 创建 并 使 用 SQLite 数 据 库 

在 本 章 中 ， 我 们 将 学 习 如 何在 Android 应 用 程序 中 保持 数据 。 由 于 用 户 硕 望 在 稍 后 阶段 中 重 
用 数据 ， 因 此 持久 化 数据 是 应 用 程序 开发 中 的 一 个 重要 主题 。 对 于 Android 来 说 ， 持 久 化 数据 主 
要 有 3 个 基本 的 方法 : 

e 用 来 保存 小 块 数据 的 轻 量 级 的 机 制 一 一 共享 首选 项 (shared preferences) 

e 传统 的 文件 系统 

@ 通过 SQLite 数 据 库 文 持 的 关系 数据 库 管 理 系统 

本 章 中 讨论 的 技术 可 以 使 应 用 程序 创建 和 访问 它们 目 己 的 私有 数据 。 在 第 7 章 ， 我 们 将 学 习 
"p ep es Ni FEE He dodo o 


6.1 保存 和 加 载 用 户 首选 项 


Android 提 供 了 SharedPreferences 对 象 来 帮助 我 们 保存 简单 的 应 用 程序 数据 。 例 如 ， 应 用 程 
序 可 能 有 一 个 允许 用 户 指定 在 应 用 程序 中 显示 的 文本 字体 大 小 的 选项 。 这 时 ， 应 用 程序 需要 记 
住 用 户 对 字体 的 设 定 值 ， 以 便 下 次 他 /她 再 次 使 用 时 ， 它 可 以 正确 设置 字体 大 小 。 为 了 达到 这 一 
目的 ， 可 以 有 多 种 选择 。 将 数据 保存 在 一 个 文件 中 ， 但 这 需要 执行 一 些 文件 管理 例 程 ， 诺 如 回 
文件 写 数 据 、 表 明 从 文件 中 读 取 了 多 少 字 符 等 。 另 外 ， 如 果 有 诸如 文本 尺寸 、 字 体 名 称 、 首 选 
的 背景 色 等 多 条 信息 需要 保存 时 ， 写 文件 的 任务 就 会 变 得 更 加 繁重 。 

奉 代 与 入 文本 文件 的 方法 是 使 用 数据 库 ， 但 无 论 是 从 开发 人 员 的 角度 还 是 考虑 到 应 用 程序 
运行 时 的 性 能 ， 存 储 价 单数 据 使 用 数据 库 都 从 张 了 点 。 

不 过 ， 使 用 SharedPreferences 对 象 的 话 ， 可 以 通过 使 用 键 / 值 对 来 保存 所 青 的 数据 一 一 为 再 
要 保存 的 数据 指定 一 个 键 ， 然 后 其 和 其 值 将 一 起 被 目 动 保 存 到 一 个 XML 文件 中 。 


6.1.1 使 用 getSharedPreferences() 方 法 


为 了 了 解 SharedPreferences 对 象 的 工作 原理 ， 下 面 的 “ 试 一 试 ” 演 示 了 可 以 很 容易 地 将 用 户 
数据 保存 到 一 个 XML 文件 中 ， 然 后 通过 同一 个 对 象 来 检索 数据 。 


AS 


使 用 SharedPreferences 对 象 保存 数据 
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SharedPreferences.zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 按 图 6-1 所 示 创 建 并 命名 一 个 Android 项 目 。 


New Android Project 


New Android Project 


Creates a new Android Project resource. 


Project name SharedPreferencez 
Contents 

© Create new project in workspace 
C Create project from existing source 
v | Use default location 


Loration | Cy Users W er Meng Lee/Begirnini ng Andreid/SharedPrefer Browse... 


C3 Create project from existing sample 


Samples: | AccelerometerP lay 


Build Target 


Target Mame Vendor 

F] Android 15 Android Open Source Project 
E| Gopgle APIs Google Inc. 

[7] Andrcid 15 Android Open Source Project 
|] Google ABI: Google Inc. 

E] Android 21-upda.. Android Open Source Project 
T Google APIs Google Inc. 

E| Android 22 Android Open Source Project 
E] Google APIs Google Inc. 

[] GALAXY Tab Add.. Samsung Electronics Co., Ltd. 
图 Android 23 Android Open Source Project 
[] Google AP: Google Inc. 


D wu CÓ [9 COO - sS PR gd Lou T 


Standard Android platform 2.3 

Properties 

Application name: SharedPreferences 

Package name: net.learmzdevelop.SsharedPreferences 
| Create Activity: MainActivity 


Min SDK Version |9 


图 6-1 


(2) 在 main.xml 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


«?xml version-"1.0" encoding-"utf-8"?» 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:orientation-"vertical" 


android:layout width-"fill parent" 


android:layout height-"fill parent" > 


«SeekBar 


android:id-"((zid/SeekBarO01" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 


«TextView 


android:id-"(trid/TextViewO01" 
android:layout width-"ftill parent" 
android:layout height-"wrap content" 
android:text-"(istring/hello" /> 
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«EditText 
android:id-'"(trid/EditText01" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 
<Button 
android:id="@+id/btnSave" 
android: text=" Save" 
android:layout width="wrap content" 
android:layout height-"wrap content" /> 
</LinearLayout> 


(3) 在 MainActivityjava 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.SharedPreferences; 


import 


import 


import 
import 
import 
import 
import 
import 
import 


android 


android 


android. 
android. 
android. 
android. 
android. 
android. 


android. 


.app.Activity; 


. 05 . Bundle; 


content.SharedPreferences; 

view.View; 

widget.Button; 

widget.EditText; 

widget.SeekBar; 
widget.SeekBar.OnSeekBarChangeListener; 
widget.Toast; 


public class MainActivity extends Activity I 


private SharedPreferences prefs; 

private String prefName - "MyPref"; 

private EditText editText; 

private SeekBar seekBar; 

private Button btn; 

private static final String FONT SIZE KEY — "fontsize"; 
private static final String TEXT VALUE KEY — "textvalue"; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


QOverride 


public void onCreate(Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


editText = (EditText) findViewById(R.id.EditTextO01); 
seekBar = (SeekBar) findViewById(R.id.SeekBar01); 


btn - 


(Button) findViewById(R.id.btnSave); 


btn.setOnClickListener (new View.OnClickListener() { 
public void onClick(View v) ( 


// -- -:kBAiSharedPreferences3]£--- 
prefs — getSharedPreferences (prefName, MODE PRIVATE); 
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SharedPreferences.Editor editor = prefs.edit(); 


//--- 将 EditText 视 图 中 的 值 保存 到 首选 项 中 --- 
editor.putFloat(FONT SIZE KEY, editText.getTextSize()); 
editor.putString(TEXT VALUE KEY, editText.getText().toString()); 


//--- 保 存 值 --- 


editor.commit(); 


//--- 显 示 文 件 被 保存 的 消息 --- 

Toast.makeText(getBaseContext(), 
"Font size saved successfully!", 
Toast.LENGTH SHORT).show(); 


12 E- 


//---Aü&SharedPreferencesXi£--- 
SharedPreferences prefs = getSharedPreferences (ppefName, MODE PRIVATE); 


//--- 将 TextView 字 体 大 小 设置 为 先前 保存 的 值 --- 
float fontSize = prefs.getFloat(FONT SIZE KEY, 12); 


/ / --- Wiss, SeekBarcllEditText--- 
seekBar.setProgress((int) fontSize); 
editText.setText(prefs.getString(TEXT VALUE KEY, "")); 
editText.setTextSize(seekBar.getProgress()); 


seekBar.setOnSeekBarChangeListener (new OnSeekBarChangelLlistener() { 
(Override 
public void onStopTrackingTouch(SeekBar seekBar) { 
] 


((Override 
public void onStartTrackingTouch(SeekBar seekBar) I 
} 


QQOverride 
public void onProgressChanged(SeekBar seekBar, int progress, 
boolean fromUser) { 
//--- 改 变 EditText 的 字体 大 小 --- 
editText.setTextSize (progress); 


)); 


(4) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 
(5) 在 EditText 视 图 中 输入 一 些 文 本 ， 然 后 通过 调整 SeekBar 视 图 改变 其 字体 大 小 (如 图 6-2 所 
示 )。 单 击 Save 按 钮 。 
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4» 5554: ndroid 2.3. Emulator WithsD 


"UN NEC 
C €» ( 
Hello World, MainActivity! Cm —— A —— 


Fu 
; 


. :S y  —/ WE 
| S X - F; | 4 — p ] ę j 
- CUN A -— ' " P di e 


sentence 
will be 
saved... 


图 6-2 
(6) 返回 Eclipse， 按 Fl1 键 再 次 在 Android 模 拟 器 上 调试 应 用 程序 。 现 在 ， 应 用 程序 将 显示 早 
先 输入 的 相同 的 文本 内 容 ， 字 体 大 小 与 先前 设 定 的 一 致 。 


示例 说 明 


为 了 使 用 SharedPreferences 对 象 ， 要 利用 getSharedPreferences(0) 方 法 ， 给 它 传 递 共 享 首 选项 
文件 的 名 称 (所 有 数据 将 保存 在 这 一 文件 中 ) 以 及 它 打 开 应 采用 的 模式 : 


private SharedPreferences prefs; 


/ / -— kBisharedPreferencesXJ$&--- 
prefs = getSharedPreferences (prefName, MODE PRIVATE); 


SharedPreferences.Editor editor = prefs.edit(); 


MODE. PRIVATE 常量 表明 共享 首选 项 文件 只 能 由 创建 它 的 应 用 程序 打开 。Editor 类 允许 利 
用 下 列 方法 将 键 / 值 对 保存 到 首选 项 文件 中 : 

€ putstring() 
putBoolean() 
putLong() 
putInt() 
putFloat() 
当 保 存 完 值 以 后 ， 调 用 commitO 方 法 来 保存 修改 : 

//--- 将 EditText 视 图 中 的 值 保存 到 首选 项 中 --- 


editor.putFloat(FONT SIZE KEY, editText.getTextSize()); 
editor.putString (TEXT VALUE KEY, editText.getText () .toString()); 


//--- 保 存 值 --- 


editor.commit(); 


HART, PH 53kHUGharedPreferences*] 5, MARA 76 BU PITE ITI PT BC: 
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//--- 加 载 sharedPreferences 对 象 --- 
SharedPreferences prefs = getSharedPreferences (prefName, MODE PRIVATE); 


/1/--- 将 TextView 字 体 大 小 设置 为 先前 保存 的 值 --- 


float fontSize = prefs.getFloat(FONT SIZE KEY, 12); 


//---—W)a8ttseekBarclEditText--- 
seekBar.setProgress((int) fontSize); 
editText.setText(prefs.getString(TEXT VALUE KEY, "")); 


editText.setTextSize(seekBar.getProgress()); 


4 [— net.learn2develop.SharedP references 
p [m lib 


共享 首选 项 文件 以 XML 文件 形式 保存 在 /dataydata/<packasge_- 4 © shared prefs 
name>/shared_prefs 文 件 炎 下 (如 图 6-3 所 示 )。 图 6.3 


<?xml version-'1.0' encoding-'utf-98' standalone-'yes' ?> 


<map> 
<string name="textvalue">This is so cool!</string> 
«float name-"fontsize" value-"75.0" /> 


«/map» 


6.1.2 使 用 getPreferences() 方 法 
前 面 章 节 中 通过 给 SharedPreferences 对 象 提 供 一 个 名 称 来 使 用 它 ， 如 下 上 所 示 : 


1//--- 芍 取 SharedPreferences 对 象 --- 
prefs = getSharedPreferences (prefName, MODE PRIVATE); 


在 这 种 情况 下 ，SharedPreferences 对 象 里 面 保存 的 信息 对 于 同一 应 用 程序 的 所 有 活动 都 是 可 
见 的 。 不 过 ， 如 果 不 需 要 在 活动 之 间 共享 数据 ， 可 以 使 用 getPreferences0 方 法 ， 如 下 所 示 : 


/ / --—HsharedPreferences3j2&--- 
prefs — getPreferences (MODE PRIVATE); 


ge tPre ferences 0 . 方 法 不 需 要 名 称 ， 保 存 的 数 据 被 限 h] 为 他 建 © 4 (EE netlearn2develop.SharedPreferences 


的 活动 。 在 这 种 情况 下 ， 首 选项 文件 的 文件 名 将 以 创建 它 的 活动 IU - 
命名 (如 图 6-4 甩 7R) o MyPref.xml 


图 6-4 
6.2. 将 数据 持久 化 到 文件 中 


SharedPreferences 对 象 允 许 您 存储 最 好 以 键 / 值 对 方式 进行 存储 的 数据 ， 例 如 用 户 ID、 生 
日 、 性 别 、 驾 照 号 码 等 数据 。 然 而 ， 有 时 您 还 是 希望 利用 传统 的 文件 系统 来 存储 数据 。 例 如 ， 
您 可 能 想 存 储 一 些 诗歌 的 文本 以 便 在 您 的 应 用 程序 中 显示 。 在 Android 中 ， 可 以 使 用 java.io 命 名 
罕 间 中 的 类 来 做 到 这 一 点 。 


6.2.1 保存 到 内 部 存储 器 


Android 应 用 程序 中 保存 文件 的 第 一 个 方法 就 是 将 其 写 入 设备 的 内 部 存储 右 。 下 和 面 的 “ 试 一 
试 ” 展 示 了 如 何 将 用 户 输入 的 一 个 字符 串 保 存 到 设备 的 内 部 存储 天 中 。 
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将 数据 保存 到 内 部 存储 器 


Files.zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 按 图 6-5 所 示 创 建 并 命名 一 个 Android 项 目 。 


WE. New Android Project 


Hew Android Project 
Creates a new Åndroid Project resource. 


Project name [rw 


Contents 

E Create new project in workspace 
© Creste project from wasting source 
3 Use default location 


Location: |En Users Wei-Meng Les Beginning Android? Files 
7 Create project from existing sample 


Samples: | AccelerometerPlen 
Build Target 


Target Mame Vendor 

[7] Android 1.5 Android Open Source Praject 
E| Google AFi Google Inz. 

[^| Android 1.5 Android Open Source Project 
[O] Gengle APIs Google Inc. 

[7] Android 21-u Android Dpen Source Project 
[7] Gengle APIs Google Inc. 

[^] Android 22 Android Öpen Source Project 
[7] Gengle APIs Google Inc. 

[7] GALAXY Tab Addon Samsung Electronics Co, Ltd. 
[F| Android 2.3 Åndroid Üpen Source Project 
[] Google APIs Google Inc. 


Standard Android platform 2.3 


Properties 
Application name: Files 


Package name: net.leamz develop.Fil es 


(2) 在 main.xml 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


«?xml version-"1.0" encoding-"utf-8"?- 


«LinearLayout xmlns:android-"http://schemas.android 


android: 
android: 


android: 


«TextView 
android 
android 
android 
/? 

«EditText 


android: 


android 


«Button 
android 


android 
android 


orientation-"vertical" 
layout width-"fill parent" 
layout height-"fill parent" > 


: layout width-"fill parent" 
:layout height-"wrap content" 


:text-"Please enter some text" 


id=" @+id/txtText1" 


: layout width-"fill parent" 
android: 


layout height="wrap content" /> 


:id="@+id/btnSave" 
android: 


text=" Save" 


:layout width-"fill parent" 
:layout height-"wrap content" /> 


.com/apk/res/android" 
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«Button 
android:id-"(ü(rid/btnLoad" 
android:text-"Load" 
android:layout width-"ftill parent" 
android:layout height-"wrap content" /> 
</LinearLayout> 


(3) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Files; 


import android.app.Activity; 


import android.view.View; 


import java.io.FileInputStream; 
import java.io.FileOutputStream; 
import java.io.lOException; 

import java.io.InputStreamReader; 
import java.io.OutputStreamWriter; 
import android.os.Bundle; 

import android.widget.Button; 
import android.widget.EditText; 
import android.widget.Toast; 


public class MainActivity extends Activity I 
private EditText textBox; 
private static final int READ BLOCK SIZE = 100; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView (R. layout .main); 


textBox = (EditText) findViewById(R.id.txtText1l); 
Button saveBtn - (Button) fidViewById(R.id.btnSave); 
Button loadBtn = (Button) findViewById(R.id.btnLoad); 


saveBtn.setOnClickListener (new View.OnClickListener() { 
public void onClick(View v) ( 
String str - textBox.getText().toString(); 
try 
t 
FileOutputStream fOut - 
openFileOutput("textfile.txt", 
MODE WORLD READABLE); 
OutputStreamWriter osw - new 
OutputStreamWriter (fOut); 


//--- 将 字符 串 写 入 文件 --- 
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osw.write(str); 
osw.flush(); 


osw.close(); 


//--- 显 示 文 件 被 保存 的 消息 --- 

Toast.makeText(getBaseContext(), 
"File saved successfully!", 
Toast.LENGTH SHORT).show(); 


/ / - - iB EditText--- 
textBox.setText(""); 


] 
catch (IOException ioe) 
i 
ioe.printStackTrace(); 
] 


IRI 


loadBtn.setOnClickListener (new View.OnClickListener() ( 
public void onClick(View v) { 
try 
{ 
FilelnputStream fln - 
openFileInput("textfile.txt"); 
InputStreamReader isr - new 
InputStreamReader (fIn); 


char[] inputBuffer — new char[READ BLOCK SIZE]; 
String s = ""; 


int charRead; 
while ((charRead = isr.read(inputBuffer))»0) 
{ 
//--- 将 字符 转换 成 字符 串 --- 
String readString = 
String.copyValueOf(inputBuffer, O0, 
charRead); 


S += readString; 


inputBuffer — new char[READ BLOCK SIZE]; 
] 
//--- 将 EditText 设 置 为 已 读 取 的 文本 --- 
textBox.setText(s); 


Toast.makeText(getBaseContext(), 
"File loaded successfully!", 
Toast.LENGTH SHORT).show(); 

} 
catch (IOException ioe) { 
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ioe.printStackTrace(); 
}); 


} 


(4) 按 Fl1 键 在 Android 模 拟 器 上 调试 应 用 程序 。 
(5) 在 EditText 视 图 中 输入 一 些 文本 (如 图 6-6 所 示 )， 然 后 单 击 Save 按 钮 。 


a 5554 Android 2.3 Emulatar 


AB xoa A ran NE 


Files 

p | Please enter some text Ms | N 
PRI | | | | J 
| This is a string of text... A © d o P e , 
| | . 

pt Save m O | "um 


O ec e a) 


re 


AM | W 
m M^ s rr 
—...| Bague 


SYM Ed 


图 6-6 
(6) 如 果 文 件 成 功 保存 ， 将 看 到 由 Toast 类 显示 出 的 消 县 “File saved successfully!”。EditText 


视图 中 的 文本 将 消失 。 
(7) 单 击 Load 按 钮 ， 将 义 会 看 到 字符 串 出 现在 EditText 视 图 中 。 这 表明 文本 被 正确 地 你 存 了 。 
示例 说 明 
为 了 将 文本 保存 到 文件 中 ， 要 使 用 FileOutputStream 类 。openFileOutput() 方 法 用 指定 的 模 
式 ， 打 开 一 个 指定 的 文件 来 写 入 。 在 本 例 中 ， 使 用 MODE_WORLD_ READABLE 常 量 来 表示 此 
文件 可 被 其 他 所 有 应 用 程序 读 取 : 
FileOutputStream fOut = 


openFileOutput ("textfile.txt", 
MODE WORLD READABLE); 


除了 MODE_WORLD_READABLE 常 量 之 外 ， 还 可 以 从 以 下 模式 中 进行 选择 : MODE. 
PRIVATE( 文 件 只 能 被 创建 它 的 应 用 程序 访问 )、MODE_APPEND( 附 加 到 现 有 文件 ) 和 MODE_ 
WORLD_WRITEABLE( 文 件 对 于 其 他 所 有 应 用 程序 来 说 都 是 可 写 的 )。 

为 了 将 字符 流转 换 为 字 节 流 ， 要 利用 OutputStreamWriter 类 的 一 个 实例 ， 并 给 它 传 递 一 个 
FileOutputStream 对 象 的 实例 : 
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OutputStreamWriter osw — new 
OutputStreamWriter(ü(fOut); 


然后 使 用 其 write() 方 法 将 字符 串 写 入 到 文件 中 。 使 用 ftushgO 方 法 来 保证 所 有 学 节 都 写 入 文 
件 。 最 后 ， 使 用 close0) 方 法 来 关闭 文件 : 


osw.write(str); 
osw.flush(); 


osw.close(); 
为 了 读 取 文件 内 容 ，FileInputStream 类 和 InputStreamReader 类 要 配合 使 用 : 


FileInputstream fIn = 
openFileInput ("Ltextfile.txt"); 
InputStreamHReader isr = new 


InputStreamReader (fIn); 


由 于 不 清楚 要 读 取 的 文件 的 大 小 ， 因 此 按 100 个 字符 为 一 块 将 文件 内 容 读 到 缓冲 区 (字符 数 


char[] inputBuffer = new char[READ BLOCK SIZE]; 


String s = ""; 


int charRead; 
while ((charRead = isr.read(inputBuffer))^»0) 
1 
//--- 将 字符 转换 为 字符 串 --- 
String readString = 
String.copyValueOf(inputBuffer, 0, 
charkRead); 


S += readString; 


inputBuffer = new char[READ BLOCK SIZE]; 


InputStreamReader 对 象 的 read0) 方 法 读 取 所 读 字 符 个 数 ， 如 果 到 达 文 件 末尾 就 返回 -1。 
当 在 Android 模 拟 器 上 测试 此 应 用 程序 时 ， 可 以 使 用 DDMS 来 验证 应 用 程序 的 确 将 文件 保存 
在 了 其 files 日 录 中 (如 图 6-7 所 示 ; 实际 上 日 录 是 /data/data/net.learn2develop.Files/files)。 
f DDMS - Files/src/net/learr2develop/Files/MainActvity.java - Eclipse 


Fax &3 06 1d :$&-0-Q- :由 了 党 > Ej $* Debug [iii DOM 


[LES 二 E x ^ ua I 
E u^ e g ll a ~" Ta cm k= Ar — = cm 


r4 s, 


B] Devices e mL $ Threads | (8l Heap | (B Allocation Tracker im File Explorer £x. 


X | d; o: v| 3 |El B CU | Name Sim | Date 
Mame ^ b [2 Jp.co.omronscft.openwnn 2010-12-24 
b [2» netlearn2develop.ContentProviders 2010-12-24 
4 [EE netlearn2develop.Filez 2010-12-24 
4 [p files 2010-12-24 
textfil e.txt 2010-12-24 
t E lib 2010-12-24 
b [m netlearn2develop.Previder 2010-12-24 
p [£» dontpanic 2010-12-11 
b Æ local 2010-12-11 
b EE last-found 2010-12-11 
b E mist 2010-12-11 


图 6-7 


国 emulator-5554 
system process 
]p.co.ornronsoft.openwnn 
cnm.andreid.launcher 
corn.android.systernui 
com.android.phone 
android.process. media 
cnm.andraid.cquicksearchhox 
CDIT.SYOXpiro 
com.android.defcontainer 
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6.2.2 ”保存 到 外 部 存储 器 (SD 卡 ) 


前 面 一 节 讲 述 了 如 何 将 文件 保存 到 Android 设 备 的 内 部 存储 器 。 有 时， 将 文件 保存 到 外 部 存 
储 器 也 是 很 有 用 的 ， 这 是 因为 外 部 存储 器 (例如 SD 卡 ) 容 量 大 ， 而 且 很 容易 和 其 他 用 户 共享 文件 
只 要 将 SD 卡 移 到 别人 的 设备 里 就 行 了 )。 
使 用 前 一 节 中 创建 的 项 目 作 为 例子 ， 为 了 将 用 户 输 入 的 文本 保存 在 SD 卡 中 ， 按 粗 体 显 示 内 
容 修改 Save 按 钮 的 onClick() 方 法 : 


saveBtn.setOnClickListener(new View.OnClickListener() { 


public void onClick(View v) { 


String str = textBox.getText().toStringq(); 

try 

| 
//---SD 卡 存储 器 --- 
File sdCard - Environment.getExternalStorageDirectory(); 
File directory = new File (sdCard.getAbsolutePath() + 

"/MyFiles"); 

directory.mkdirs(); 
File file = new File (directory, "textfile.txt"); 
FileOutputStream fOut = new FileOutputStream (file) ; 


OutputStreamWriter osw = new 
OutputStreamWriter (fOut); 


//--- 将 字符 串 写 入 文件 --- 
OSW.write(üstr); 
osw.flush(); 


osw.close(t); 


//--- 显 示 文 件 被 保存 的 消息 --- 

Toast.makeText(getBaseContext () ， 
"File saved successfully!", 
Toast.LENGTH SHORT).show(); 


//-——B S EditText--- 


textBox.setText(""); 


} 
catch (IOException ioe) 
{ 
ioe.printStackTrace(); 
} 


)): 


上 述 代码 使 用 getExternalStorageDirectory(0) 方 法 返回 外 部 存储 器 的 完整 路 径 。 一 般 地 ， 对 于 
真实 设备 返回 /sdcard 路 径 ， 对 于 Android 模 拟 需 返回 /mntysdcard 路 径 。 然 而 ， 永 远 不 要 试 几 用 便 
编码 的 方式 指定 SD 卡 的 路 径 ， 因 为 制造 商 可 能 会 给 SD 卡 指派 一 个 不 同 的 路 径 名 称 。 因 此 ， 应 确 
保 使 用 getExternalStorageDirectory(0) 方 法 来 返回 指 丫 SD 卡 的 完整 路 径 。 
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然后 在 SD 卡 中 创建 一 个 名 为 MyFiles 的 目录 。 最 终 ， 文 件 将 保存 在 此 目录 下 
为 了 从 外 部 存储 右 中 加 载 文件 ， 需 要 为 Load 扔 钮 修改 onClick0) 方 法 : 


loadBtn.setonClickListener(new View.OnClickListener() i 
public void onClick(View v) 1 

七 工 Y 

{ 
//---SD 存 储 器 --- 
File sdCard = Environment.getExternalStorageDirectory(); 
File directory = new File (sdCard.getAbsolutePath() + 

"/MyFiles"); 
File file = new File(directory, "textfile.txt"); 
FilelnputStream fln = new FilelInputStream (file) ; 
Reader isr = new InputStreamReader (fIn); 


char[] inputBuffer = new char[READ BLOCK SIZE]; 


String s e e 


int charRead; 


while ((charRead = isr.read(inputBuffer))^»0) 


1 
//--- 将 字符 转换 为 字符 串 --- 
String readString = 
String.copyValueOf(inputBuffer, 0, charRead); 
s += readString; 
inputBuffer = new char [READ BLOCK SIZE]; 
} 


/ / --— fiEditTexti& E79 C ERU SCA — - 


textBox.setText(s); 


Toast.makeText(getBaseContext(), 
"File loaded successfully!", 
Toast.LENGTH SHORT).show(); 

} 
catch (IOException ioe) 1 


ioe.printStackTrace(); 


: 意 ， 要 写 入 到 外 部 存储 器 ， 需 要 在 AndroidManifest.xml 文 件 中 添加 WRITE EXTERNAL _ 
Wk 限 : 


<?xml version-"1.0" encoding-"utfí-98"?-» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Files" 
android:versionCode-"]" 


android:versionName-"1.0"» 
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«application android:icon="@drawable/icon" android:label-"8string/app name"> 


«activity android:name-".MainActivity" 
android:label-"Qstring/app name"- 
«intent-filter» 


«action android:name-"android.intent.action.MAIN" /> 


«category android:name-"android.intent.category.LAUNCHER" /» 


«/intent-filter» 
«/activity» 
«/application» 


«uses-sdk android:minSdkVersion-"9" /> 


«uses-permission android:name-"android.permission.WRITE EXTERNAL STORAGE"» 


«/uses-permission» 


«/manifest» 


6.2.3 选择 最 佳 存 储 选 项 


目 亲 ， 您 已 经 了 解 到 几 种 在 Android 应 用 程序 中 保存 数据 的 方法 一 一 SharedPreferences、 内 


部 存储 硕 和 外 部 存储 右 。 在 应 用 程序 中 应 该 选择 哪 一 种 呢 ? 以 下 是 一 些 建 议 : 


e ” 旭 果 数据 可 以 用 键 / 值 对 表示 ， 那 么 使 用 SharedPreferences 对 象 。 人 例如， 如果 想 要 存储 用 户 首 
选项 的 数据 ， 如 用 户 姓 名 、 背 景色 、 生 日 、 最 后 登录 日 期 等 ， 那 么 使 用 SharedPreferences 对 
象 来 存储 这 些 数据 是 一 个 理想 的 方法 。 而 且 ， 您 也 不 用 亲自 操心 这 些 数 据 是 如 何 存储 的 ; 


所 有 需要 您 做 的 只 是 使 用 SharedPreferences 对 象 存储 和 检索 它们 。 


e 如 果 笛 要 存储 临时 数据 ， 使 用 内 部 存储 器 是 一 个 好 的 选择 。 例 如 ， 应 用 程序 (如 一 个 RSS 阅 
恋 需 ) 可 能 需要 显示 从 Web 上 下 载 的 图 像 。 在 这 种 情况 下 ， 将 图 像 保 存在 内 部 存储 右上 是 一 
个 好 的 解决 方法 。 您 也 许 还 希望 持久 化 用 户 所 创建 的 数据 ， 例 如 有 一 个 备 起 录 应 用 程序 可 
以 用 来 让 用 户 记 些 笔记 并 保存 它们 以 备 后 用 。 在 所 有 这 些 情况 下 ， 使 用 内 部 存储 右 是 一 个 


好 的 选择 。 


e 有 时 需要 和 其 他 用 户 共 吾 应 用 程序 数据 。 例 如 ， 您 创建 了 一 个 Android 应 用 程序 来 记录 用 户 曾 
经 去 过 的 地 点 的 坐标 ， 并 想 与 其 他 用 户 分 至 这 些 数据 。 在 这 种 情况 下 ， 可 以 将 文件 存储 在 设 
备 的 SD 卡 上 ， 这 样 用 户 在 后 面 可 以 很 容易 地 将 数据 转移 到 其 他 设备 (和 计算 机 ) 上 来 使 用 。 


6.2.4 使 用 静态 资源 


除了 在 运行 时 动态 地 创建 和 使 用 文件 之 外 ， 还 可 以 在 设计 时 将 文件 
添加 到 包 ， 以 便于 在 运行 时 使 用 它 。 例 如 ， 您 可 能 需要 与 包 捆 绑 一 些 帮 
助 文 件 ， 以 便于 用 户 需 要 时 可 以 显示 一 些 帮 助 信息 。 这 时 ， 可 以 在 包 下 
面 的 res/raw 文 件 严 (需要 目 己 创建 ) 下 添加 文件 。 图 6-8 显 示 了 res/raw 文 件 
夹 包含 了 一 个 名 为 textfile.txt 的 文件 。 

为 了 在 代码 中 使 用 此 文件 ， 要 利用 getResources() 方 法 返回 一 个 
Resources 对 象 ， 然 后 使 用 其 openRawResources() 方 法 来 打开 包含 在 res/ 
raw 文 件 夹 下 的 文件 : 


import java.io.InputStream; 
import java.io.BufferedReader; 


r da res 
> (£z drawable-hdpi 
> Œ drawable-ldpi 
> (EE drawable-mdpi 
4 & layout 


(Xj main.xml 
4 [£2 raw 
| [B] textfile.txt 
b E values 
器 AndroidManifest.xml 


图 6-8 
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/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


InputStream is = this.getResources ().openRawResource (R. raw. textfile) ; 
BufferedReader br = new BufferedReader (new InputStreamReader (is)); 
String str = null; 
try { 

while ((str = br.readLine()) != null) { 

Toast.makeText(getBaseContext(), 
str, Toast.LENGTH SHORT).show(); 
} 


is.close(); 
br.close(); 
} catch (IOException e) ( 


e.printStackTrace(); 


textBox = (EditText) findViewById(R.id.txtText1); 
Button saveBtn = (Button) fíindViewById(R.id.btnSave); 
Button loadBtn = (Button) findViewById(R.id.btnLoad); 


saveBtn.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
} 

I 


loadBtn.setoOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
} 

}); 


存储 在 resraw 文 件 夹 下 的 资源 的 ID 是 以 其 文件 名 来 俞 名 的 ， 不 带 扩 展 名 。 人 例如， 如果 文本 
文件 是 textfile.txt， 那 么 它 的 资源 用 就 是 R.raw.textfile。 


6.3 创建 和 使 用 数据 库 


到 目前 为 止 ,您 所 看 到 的 所 有 技术 都 用 来 保存 简单 的 数据 集合 。 对 于 存储 关系 型 数据 ， 使 
用 数据 库 会 更 有 效 。 例 如 ， 如 果 您 想 存 储 一 所 学 校 所 有 学 生 的 结果 ， 那 么 使 用 数据 库 来 表示 它 
们 要 有 效 得 多 ， 因 为 可 以 使 用 数据 库 查 询 来 检索 一 个 特定 学 生 的 结果 。 此 外 ， 使 用 数据 库 可 以 
通过 在 不 同 数据 集合 间 指 定 关 系 来 强制 数据 完整 性 。 

Android 使 用 的 是 SQLite 数 据 库 系统 。 为 一 个 应 用 程序 所 创建 的 数据 库 只 能 被 此 应 用 程序 访 
问 ; 其 他 应 用 程序 将 不 能 访问 它 。 

本 节 中 ， 将 学 习 如 何以 编程 方式 在 Android 应 用 程序 中 创建 一 个 SQLite 数 据 库 。 对 于 
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Android， 在 一 个 应 用 程序 中 以 编程 方式 创建 的 SQLite 数 据 库 弟弟 存储 在 /data/data/<package_ 
name>/databases XF F. 


6.3.1 创建 DBAdapter 辅 助 类 


处 理 数 据 库 的 一 个 好 的 做 法 是 创建 一 个 辅助 关 来 封装 访问 数据 的 所 有 复杂 性 ， 使 对 于 调用 它 
的 代码 来 说 是 透明 的 。 因 此 ， 在 本 节 中 将 创建 一 个 名 为 DBAdapter 的 辅 
| 类 ， xz dr m AX BREED S — ANQ to TE C—C — lA ] 
助 类 ， 用 来 创建 、 打 开 、 关 闭 和 使 用 一 个 SQLite 数 据 库 | [一 让 一 
本 例 中 ， 将 创建 一 个 名 为 MyDB 的 数据 库 ， 包 含 一 张 名 为 contacts | EE | 
的 表 。 这 个 表 有 3 列 : _id、name 和 email( 如 图 6-9 所 示 )。 图 6-9 


amv 明 创建 数据 库 辅助 类 


Databases. zip 代 码 文件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 Databases 的 Android 项 目 。 4 eS — 
(2) 在 项 目 中 新 增 一 个 类 文件 ， 并 命名 为 DBAdapter.java( 如 . 8 — — "nnn 
k D DBAdapter.java 
E 6- 10 所 泵 )。 > D Main Arini java 


; E gen [Generated Java Files] 


(3) 在 DBAdapter.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 
&| 6-10 


package net.learn2develop.Databases; 


import android.content.ContentValues; 

import android.content.Context; 

import android.database.Cursor; 

import android.database.SQLException; 

import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteOpenHelper; 
import android.util.Log; 


public class DBAdapter 1{ 
public static final String KEY ROWID = " id"; 
public static final String KEY NAME = "name"; 
public static final String KEY EMAIL = "email"; 
private static final String TAG = "DBAdapter'"; 


private static final String DATABASE NAME = "MyDB"'"; 
private static final String DATABASE TABLE = "contacts"; 
private static final int DATABASE VERSION - 1; 
private static final String DATABASE CREATE = 
"create table contacts ( id integer primary key autoincrement, " 


- "name text not null, email text not null);"; 


private final Context context; 
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private DatabaseHelper DBHelper; 
private SQLiteDatabase db; 


public DBAdapter(Context ctx) 
| 


this.context = ctx; 


DBHelper = new DatabaseHelper (context); 


private static class DatabaseHelper extends SQLiteOpenHelper 


{ 
DatabaseHelper (Context context) 


{ 
super(context, DATABASE NAME, null, DATABASE VERSION); 
} 
QOverride 
public void onCreate(SQLiteDatabase db) 
{ 
try ( 
db.execSQL(DATABASE CREATE); 
) catch (SQLException e) 1 
e.printStackTrace(); 
f 
] 
GOverride 


public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) 
i 
Log.w(TAG, "Upgrading database from version " + oldVersion + " to " 
+ newVersion + ", which will destroy all old data"); 
db.execSQL("DROP TABLE IF EXISTS contacts"); 
onCreate (db); 


//--- 打 开 数 据 库 --- 
public DBAdapter open() throws SQLException 
{ 
db = DBHelper.getWritableDatabase(); 
return this; 


//--- 关 闭 数据 库 --- 
public void close() 


{ 
DBHelper.close(); 


//--- 在 数据 库 中 插入 一 个 联系 人 --- 
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public long insertContact(String name, String email) 

i 
ContentValues initialValues = new ContentValues(); 
initialValues.put(KEY NAME, name); 
initialValues.put(KEY EMAIL, email); 
return db.insert(DATABASE TABLE, null, initialValues); 


//--- 删 除 一 个 特定 的 联系 人 --- 
public boolean deleteContact(long rowId) 
{ 
return db.delete (DATABASE TABLE, KEY ROWID + "=" + rowId, null) > 0; 


//--- 检 索 所 有 的 联系 人 --- 
public Cursor getAllContacts () 
i 
return db.query (DATABASE TABLE, new String[] (KEY ROWID, KEY NAME, 
KEY EMAIL), null, null, null, null, null); 


//--- 检 索 一 个 特定 的 联系 人 --- 
public Cursor getContact(long rowld) throws SQLException 
i 
Cursor mCursor - 
db.query (true, DATABASE TABLE, new String[] (KEY ROWID, 
KEY NAME, KEY EMAIL), KEY ROWID + "=" + rowId, null, 
null, null, null, null); 
if (mCursor !- null) { 
mCursor.moveToFirst(); 
] 


return mCursor; 


//--- 更 新 一 个 联系 人 --- 
public boolean updateContact(long rowld, String name, String email) 
i 

ContentValues args - new ContentValues(); 

args.put(KEY NAME, name); 

args.put(KEY EMAIL, email); 

return db.update(DATABASE TABLE, args, KEY ROWID + "=" + rowld, 
null) » 0; 

} 


示例 说 明 
首先 为 在 数据 库 中 将 要 创建 的 表 定 义 儿 个 第 量 来 包含 不 同 的 子 段 : 


public static final String KEY ROWID = " id"; 
public static final String KEY NAME = "name"; 
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public static final String KEY EMAIL = "email"; 
private static final String TAG = "DBAdapter'"; 


private static final String DATABASE NAME = "MyDB"; 
private static final String DATABASE TABLE = "contacts"; 
private static final int DATABASE VERSION - 1; 


private static final String DATABASE CREATE = 
"create table contacts ( id integer primary key autoincrement, " 


+ "name text not null, email text not null);"; 


特别 是 ，DATABASE CREATE? EEA T HH T 4EMyDBZitis Fern Gl contacts I)JSQL 1&8 AJ. 
在 DBAdapter 类 中 ， 还 扩展 了 SQLiteOpenHelper 类 ， 它 是 一 个 在 Android 中 用 来 处 理 数 据 库 
创建 和 版 本 管理 的 辅助 类 。 尤 其 是 ， 它 重 写 了 onCreate(0) 方 法 和 onUpgrade() 方 法 : 


public class DBAdapter 1 
public static final String KEY ROWID = " id"; 
public static final String KEY NAME = "name"; 
public static final String KEY EMAIL = "email"; 
private static final String TAG = "DBAdapter"; 


private static final String DATABASE NAME = "MyDB"; 
private static final String DATABASE TABLE = "contacts"; 
private static final int DATABASE VERSION - 1; 


private static final String DATABASE CREATE — 
"create table contacts ( id integer primary key autoincrement, 


+ "name text not null, email text not null);"; 
private final Context context; 


private DatabaseHelper DBHelper; 
private SQLiteDatabase db; 


public DBAdapter(Context ctx) 
i 


this.context - ctx; 


DBHelper = new DatabaseHelper (context); 


private static class DatabaseHelper extends SQLiteOpenHelper 


{ 
DatabaseHelper (Context context) 


{ 
super(context, DATABASE NAME, null, DATABASE VERSION); 


(Override 
public void onCreate(SQLiteDatabase db) 
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{ 
try { 
db.execSQL(DATABASE CREATE); 
} catch (SQLException e) { 
e.printStackTrace(); 
} 
] 
((Override 
public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) 
i 
Log.w(TAG, "Upgrading database from version " + oldVersion + " to " 
+ newVersion + ", which will destroy all old data"); 
db.execSQL("DROP TABLE IF EXISTS contacts"); 
onCreate (db); 
] 


onCrfreate() 方 法 在 所 需 数 据 库 不 存在 时 创建 一 个 新 的 数据 库 。onUpgrade0 方 法 在 数据 库 
需要 升级 时 调用 。 这 可 以 通过 检查 在 DATABASE_VERSION 人 常量 中 定义 的 值 来 实现 。 对 于 
onUpgrade0) 方 法 的 这 一 实现 ， 只 是 删除 表 并 再 创建 它 。 

然后 ， 可 以 定义 用 于 打开 和 关闭 数据 库 的 不 同方 法 ， 以 及 用 于 在 表 中 添加 、 人 修改、 删除 行 
的 方法 。 

public class DBAdapter { 


a 
T 


//--- 打 开 数 据 库 --- 
public DBAdapter open() throws SQLEXCeptIon 


i 
db = DBHelper.getWritableDatabase |(); 
return this; 

} 

//--- 关 闭 数据 库 --- 

public void close() 

i 
DBHelper.close(); 

} 


//--- 在 数据 库 中 插入 一 个 联系 人 --- 


public long insertContact(String name, String email) 


{ 
ContentValues initialValues = new ContentValues(); 
initialValues.put(KEY NAME, name); 
initialValues.put(KEY EMAIL, email); 
return db.insert(DATABASE TABLE, null, initialValues); 
] 


203 


Android 编 程 入 门 经 典 


//--- 删 除 一 个 特定 的 联系 人 --- 
public boolean deleteContact(long rowId) 
i 
return db.delete (DATABASE TABLE, KEY ROWID + "=" + rowId, null) > 0; 


) 


//--- 检 索 所 有 的 联系 人 --- 
public Cursor getAllContacts() 
t 
return db.query (DATABASE TABLE, new String[] (KEY ROWID, KEY NAME, 
KEY EMAIL], null, null, null, null, null); 


) 


//--- 检 索 一 个 特定 的 联系 人 --- 
public Cursor getContact(long rowld) throws SQLException 
i 
Cursor mCursor - 
db.query(true, DATABASE TABLE, new String[] (KEY ROWID, 
KEY NAME, KEY EMAIL), KEY ROWID + "=" + rowId, null, 
null, null, null, null); 
if (mCursor !- null) I 
mCursor.moveToFirst(í); 
} 
return mCursor; 


) 


//--- 更 新 一 个 联系 人 --- 
public boolean updateContact(long rowld, String name, String email) 


{ 


ContentValues args - new ContentValues(); 
args.put(KEY NAME, name); 
args.put(KEY EMAIL, email); 
return db.update(DATABASE TABLE, args, KEY ROWID + "=" + rowId, 
null) » 0; 
} 


注意 ，Android 使 用 Cursor 类 作为 查询 的 返回 值 。 可 以 将 Cursor 看 成 是 一 个 指 癌 数据 库 查 
询 的 结果 集 的 指针 。 使 用 Cursor 可 以 使 Android 更 有 效 地 按 需 要 管理 行 和 列 。 
使 用 ContentValues 对 象 来 存储 键 / 值 对 。 其 put() 方 法 可 用 于 插入 具有 不 同 数据 类 型 值 的 键 。 


6.3.2 ”以 编程 方式 使 用 数据 库 
接 下 来 将 利用 前 一 节 创 建 的 辅助 类 来 使 用 数据 库 。 
1. 添加 联系 人 
下 面 的 “ 试 一 试 ”演示 了 如 何 将 一 个 联系 人 添加 到 表 中 。 
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向 表 中 添加 联系 人 


(D 打开 先前 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Databases; 


import android.app.Activity; 


import android.os.Bundle; 


public class MainActivity extends Activity I 


) 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 


public void onCreate(Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 
DBAdapter db = new DBAdapter (this); 


//--- 添 加 一 个 联系 人 --- 
db.open(); 

long id = db.insertContact("Wei-Meng Lee", "weimengleeQ 
learn2develop.net"); 

id = db.insertContact("Mary Jackson", "mary(jackson.com"); 
db.close(); 


(2) TZF118EZEAndroid E17 28. E V8 UV. HERE. 


示例 说 明 


在 这 个 例子 中 ， 首 先 创建 了 一 个 DBAdapter 类 的 实例 : 


DBAdapter db = new DBAdapter (this); 


insertContactO 方 法 返回 所 搬入 行 的 ID。 如 果 在 操作 中 发 生 错误 a 局 netleam2develop.Databases 


则 返回 -1。 
如 果 使 用 DDMS 检 查 Android 设 备 /模拟 器 的 文件 系统 ， 可 以 看 到 
在 databases 文 件 夹 下 创建 了 MyDB 数 据 库 ( 如 图 6-11 所 示 )。 


图 6-11 


2. 检索 所 有 联系 人 
为 了 在 contacts 表 中 检索 所 有 联系 人 ， 使 用 DBAdapter 类 的 getAllContacts0) 方 法 ， 如 下 面 的 


“ 试 一 试 ”所 示 。 


从 表 中 检索 所 有 联系 人 


(1) 打开 先前 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
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package net.learn2develop.Databases; 


import android.app.Activity; 
import android.os.Bundle; 


import android.widget.Toast; 
import android.database.Cursor; 


public class MainActivity extends Activity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
GOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


DBAdapter db = new DBAdapter (this); 


/* 

/ /一 一 -添加 一 个 联系 人 一 一- 

db.open(); 

long id = db.insertContact("Wei-Meng Lee", "weimengleeg 


learn2develop.net"); 


id = db.insertContact("Mary Jackson", "maryü8jackson.com"); 
db.close(t); 
*/ 


//--- 获 取 所 有 联系 人 --- 
db.open(); 
Cursor c = db.getAllContacts(); 
if (c.moveToFirst()) 
{ 

do ( 

DisplayContact(o); 

} while (c.moveToNext()); 
} 
db.close(); 


public void DisplayContact(Cursor c) 


i 
Toast.makeText(this, 
"id: " + c.getString(0) + "Mn" + 
"Name: " + c.getString(1) + "Mn" + 
"Email: " + c.getString(2), 
Toast.LENGTH LONG).show(); 
) 


(2) 按 Fl11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 图 6-12 展 示 了 Toast 类 所 显示 的 从 数据 库 中 检 
索 到 的 联系 人 。 
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& 5554: Android 2.3 Emulator WithSD 


Hello World, MairActivity! e eo e © 
| i | j | 
z A _ E y | E 

| 


©0009 


a f2 fa ta |s fe dz |s |» fo] 
| Mane SECM Eng sl pt n epee pip p oe 
| Email: weimengleet?learn2develop.ne | A le EUG j K L 
会 lz lx fe Iv [e [n Ju. Je 
eE PUN 


6-12 


示例 说 明 

DBAdapter 类 的 getAllContacts(0) 方 法 检索 存储 于 数据 库 中 的 所 有 联系 人 。 结 果 以 Cursor 对 象 
形式 返回 。 为 了 显示 所 有 联系 人 ， 首 先 需要 调用 Cursor 对 象 的 moveIToFirst(0 方 法 。 如 果 成 功 (这 
意味 看 至 少 有 一 行 可 用 )， 则 使 用 DisplayContactO 方 法 来 显示 联系 人 的 详细 信息 。 要 移动 到 下 一 
个 联系 人 ， 则 要 调用 Cursor 对 象 的 moveToNext() 方 法 。 

3. 检索 单个 联系 人 

要 利用 联系 人 的 ID 来 检索 单个 联系 人 ， 可 按 下 面 的 “ 试 一 试 ” 所 展示 的 ， 调 用 DBAdapter 类 
的 getContact() 方 法 。 


Le dE 从 表 中 检索 单个 联系 人 


(1) 打开 先前 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


DBAdapter db = new DBAdapter (this); 


ra 

/ /一 -添加 一 个 联系 人 -一 - 
Pf 

i 

/* 


//--- 获 取 所 有 联系 人 --- 
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rss 
zi 


//--- 获 取 一 个 联系 人 --- 

db.open(); 

Cursor c = db.getContact(2); 

if (c.moveToFirst()) 
DisplayContact (o); 

else 
Toast.makeText(this, "No contact found", Toast.LENGTH LONG). 
show (); 

db.close(); 


(2) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 第 二 个 联系 人 的 详细 信息 将 通过 Toast 类 显示 

示例 说 明 

DBAdapter 类 的 getContactO 方 法 使 用 联系 人 的 ID 来 检索 单个 联系 人 。 传 入 联系 人 的 ID; 这 
里 传 入 的 ID 是 2， 表 明 想 要 检索 第 二 个 联系 人 : 


Cursor c — db.getContact (2); 


结果 以 Cursor 对 象 的 形式 返回 。 如 条 返回 了 一 行 ， 束 使 用 DisplayContact(0 方 法 来 显示 其 话 细 
信息 ; 否则 使 用 Toast 类 显示 一 条 消 忆 。 


4. 更 新 联系 人 
通过 调用 DBAdapter 关 的 updateContact(0 方 法 并 传递 一 个 想 要 更 新 的 联系 人 的 ID， 可 以 实现 
对 某 个 特定 联系 人 的 更 新 操作 ， 如 下 面 的 “ 试 一 试 ” 所 示 。 


更 新 表 中 某 个 联系 人 


(1) 打开 先前 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


DBAdapter db = new DBAdapter (this); 


/* 

//--- 添 加 一 个 联系 人 --- 
ff sss 

ei 

/* 
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//--- 获 取 所 有 联系 人 ---- 
PTT 
Ei 


/* 
fiera 
i 


//--- 更 新 联系 人 --- 

db.open(); 

if (db.updateContact(1, "Wei-Meng Lee", "weimenglee(Ggmail.com")) 
Toast.makeText(this, "Update successful.", Toast.LENGTH LONG). 
show () ; 

else 
Toast.makeText(this, "Update failed.", Toast.LENGTH LONG). 
show(); 

db.close(); 

} 


(2) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 如 果 更 新 成 功 ， 将 显示 一 条 消息 。 

示例 说 明 

DBAdapter 类 中 的 updateContact(0) 方 法 利用 您 打算 更 新 的 联系 人 的 ID 来 更 新 此 联系 人 的 详细 
信息 。 它 返回 一 个 Boolean 值 ， 表 明 更 新 是 否 成 功 。 


5. 删除 一 个 联系 人 

使 用 DBAdapter 类 的 deleteContact() 方 法 并 传递 一 个 想 要 删除 的 联系 人 的 ID， 可 以 实现 对 某 
个 联系 人 的 删除 操作 ， 如 下 面 的 “ 试 一 试 ”所 示 。 
删除 表 中 某 个 联系 人 


(D 打开 先前 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


DBAdapter db = new DBAdapter(this); 


/* 

//--- 添 加 一 个 联系 人 -=-- 
Iw 

di 

/* 


/ | - — RBS ERR -—— 
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Pss 
gi 


/* 

//--- 获 取 一 个 联系 人 --- 
7 

*/ 


/* 
//--- 更 新 联系 人 --- 
原本 


/V--- 删 除 一 个 联系 人 --- 

db.open(); 

if (db.deleteContact(1)) 
Toast.makeText(this, "Delete successful.", Toast.LENGTH LONG). 
show () ; 

else 
Toast.makeText(this, "Delete failed.", Toast.LENGTH LONG). 
show () ; 

db.close(); 


(2) 按 Fl1 键 在 Android 模 拟 器 上 调试 应 用 程序 。 如 果 删 除 成 功 ， 将 显示 一 条 消 居 。 

示例 说 明 

DBAdapter 类 中 的 deleteContact0O 方 法 利用 您 打算 更 新 的 联系 人 的 ID 来 删除 此 联系 人 。 它 返 
回 一 个 Boolean 值 ， 表 明 删 除 是 否 成 功 。 


6. 升级 数据 库 


有 时 ， 在 创建 和 开始 使 用 数据 库 之 后 ， 您 可 能 需要 谎 加 另外 的 表 、 改 变数 据 库 的 模式 ， 或 者 
在 表 中 添加 一 些 列 。 这 时 ， 就 需要 将 旧 数 据 库 中 现 有 的 数据 迁移 到 一 个 新 数据 库 中 。 
要 升级 数据 库 ， 需 要 将 DATABASE_VERSION 毅 量 改 为 比 先 前 要 高 的 值 。 例 如 ， 如 果 先 前 
public class DBAdapter 1 
public static final String KEY ROWID = " id"; 
public static final String KEY NAME = "name"; 
public static final String KEY EMAIL = "email"; 
private static final String TAG = "DBAdapter"; 


private static final String DATABASE NAME = "MyDB"; 
private static final String DATABASE TABLE = "contacts"; 
private static final int DATABASE VERSION = 2; 


HAVZ TAHET, fEEclipself)LogCatf& H P uf UASA PH B: 
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DBAdapter(24096): Upgrading database from version 1 to 2, which will 
destroy all old data 


在 这 一 例子 中 ， 为 简单 起 见 ， 直 接 删 除 现 有 的 表 并 创建 一 个 新 表 。 在 实际 中 ， 通 各 需要 备 
份 现 有 的 表 ， 人 然后 将 其 内 容 复制 到 新 表 中 。 


6.3.3 Tel ESSERE 


在 实际 的 应 用 中 ， 有 时 在 设计 时 预 创 建 数据 库 要 比 在 运行 时 创建 更 有 效 。 要 预 创建 
一 个 SQLite 数 据 库 ， 可 以 使 用 Internet 上 很 多 可 用 的 免费 工具 。 其 中 一 个 这 样 的 工具 就 是 
SQLite Database Browser， 其 对 于 不 同 的 平台 都 是 免费 可 用 的 (http://sourceforge.net/projects/ 
sglitebrowser/). 

— Hz J SQLite Database Browser， 束 可 以 用 可 视 化 方式 来 创建 一 个 数据 库 。 
本 己 经 创建 好 一 个 指明 了 字段 的 contacts 表 。 


图 6-13 展 示 


ES sQUte Database Browser - C\Users\Wei-Meng Lee\Desktop\mydb 
ile Edi View Help 

[3 ap ld o | E x qr m E |n 
Database Structure | BrowseData | Execute SQL | 


CREATE TABLE contacts (id INTEGER PRIMARY KEY, name TEXT, email TEXT) 


£3 SQUte Database Browser - CAUsersWei-Meng LeeDesktopWnydb 
[Fie Edit View Help 


Du kl gm gf gg pi mf | B] |n? 
pt 
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将 数据 库 与 应 用 程序 捆绑 


在 设计 时 创建 了 数据 库 后 ， 下 一 步 要 做 的 就 是 将 其 与 应 用 程序 捆绑 ， 这 样 就 可 以 在 应 用 程 
序 中 使 用 数据 库 了 。 下 面 的 “ 试 一 试 ”展示 了 如 何 捆绑 。 


捆绑 一 个 数据 库 


(1) 打开 先前 创建 的 同一 个 项 目 ， 将 在 前 一 节 中 创建 的 SQLite 数 据 库 文 件 拖 放 到 Eclipse 中 
Android 项 目的 assets 文 件 夹 下 (如 图 6-15 所 示 )。 


" ism Databases 
4 [ES src 
4 [B net.learn2develop.Databases 
t 四 DBAdapter.java 
p "m MainActivity.java 
b RE: gen [Generated Jawa Files] 
b BE Android 2.3 


[ [59 drawable-hdpi 

[» EE drawable-Idpi 

t EE drawable-mdpi 
[» EE layout 

[ E values 

ici] AndroidManifest.xml 
default.properties 
proguard.cfg 


图 6-15 


注意 : 添加 到 assets 文 件 夹 下 的 文件 名 必须 采用 小 写字 母 格式 。 


MyDB 这 样 的 文件 名 是 无 效 的 ， 而 mydb 是 可 以 的 。 


(2) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstancesState); 
setContentView(R.layout.main); 
try ( 
String destPath = "/data/data/" + getPackageName() + 
"/databases/MyDB"; 
File f = new File(destPath); 
if (!f.exists()) ( 
CopyDB( getBaseContext().getAssets().open("'mydb"), 
new FileOutputStream(destPath)); 
] 
) catch (FileNotFoundException e) { 
e.printStackTrace(); 
) catch (IOException e) ( 


e.printStackTrace(); 


DBAdapter db = new DBAdapter (this); 


//--- 获 取 所 有 联系 人 --- 
db.open(); 
Cursor c = db.getAllContacts(); 
if (c.moveToFirst()) 
{ 

do ( 

DisplayContact(o); 

} while (c.moveToNext()); 
] 
db.close(); 


public void CopyDB(InputStream inputStream, 
OutputStream outputStream) 
throws IOException { 

//--- 一 次 复制 1K 字 节 --- 

byte[] buffer = new byte[1024]; 

int length; 
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while ((length = inputStream.read(buffer)) > 0) { 


outputStream.write(buffer, 0, length); 
) 
inputStream.close(); 


outputStream.close(); 


(3) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 当 应 用 程序 运行 时 ， 它 将 把 mydb 数 据 库 文件 
以 MyDB 为 名 复制 到 /data/data/net.learn2develop.Databases/databases/ 文 件 夹 下 。 


示例 说 明 
自 先 将 CopyDBO 方 法 定义 为 将 数据 库 文件 从 一 处 复制 到 为 一 处 : 


public void CopyDB(InputStream inputStream, 
OutputStream outputStream) 
throws IOException 1 

//-— —ÓK8lucrgT--- 

byte[] buffer = new byte[1024]; 

int length; 

while ((length - inputStream.read(buffer)) > 0) 

outputStream.write(buffer, O0, length); 
} 
inputStream.close(); 


outputStream.close(); 


Í 


注意 ， 在 这 种 情况 下 ， 使 用 InputStream 对 象 来 从 源 文件 中 读 取 数据 ， 然 后 使 用 OutputStream 


对 象 将 其 写 入 到 目标 文件 中 。 


当 活 动 被 创建 时 ， 将 位 于 assets 文 件 夹 下 的 数据 库 文件 复制 到 Android 设 备 (或 模拟 右 ) 上 的 


/data/data/net.learn2develop.Databases/databases/ 文 件 夹 下 : 
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try 1 
String destPath - "/data/data/" + getPackageName() 十 
"/databases/MyDB"; 
File f = new File(destPath); 
if (!f.exists()) |l 
CopyDB( getBaseContext ().getAssets().open("mydb"), 
new FileOutputStream(destPath)); 
} 
) catch (FileNotFoundException e) { 
e.printStackTrace(); 
} catch (IOException e) | 
e.printStackTrace(); 


} 


只 有 在 目标 文件 夹 下 不 存在 数据 库 文 件 时 才 执 行 复制 操作 。 如 果 不 进 行 这 一 检查 ， 每 一 
次 创建 活动 时 ， 数 据 库 文 件 将 被 assets 文 件 夹 下 的 文件 所 覆盖 。 这 也 许 是 您 所 不 希望 的 ， 因 为 应 
用 程序 在 运行 时 很 可 能 会 对 数据 库 文 件 做 修改 ， 这 将 消除 到 目前 为 止 您 对 数据 库 所 做 出 的 一 切 

为 了 确保 数据 库 文件 的 确 被 复制 了 ， 在 测试 应 用 程序 之 前 要 确保 在 模拟 器 中 删除 了 数据 库 
文件 (如 果 还 存在 的 话 )。 可 以 使 用 DDMS 来 删除 数据 库 ( 如 图 6-16 所 示 )。 


$% Threads | @ Heap | 国 Allocation Tracker |! File Explor 


Name Date Time Permissions | | Delete the selection. 
b E com.svox.pico 2010-12-24 1218  drwxr-x--x — i 

b [E jp.co.omronsoft.openwnn 2010-12-24 1238  drwxr-x--x 

4 [> net.learn2develop.Databases 2010-12-25 04:24 — drwxr-x--x 

4 [— databases 2010-12-25 04:25  drwxrwx--x 

E) MyDB 2010-12-25 04:25  -rw-rw---- 


b (m lib 2010-12-25 04:224 drwxr-xr-x 
b [E net.learn2develop.Files 2010-12-24 12:51  drwxr-x--x 
- [£z net.learn2develop.SharedPreferences 2010-12-25 020  drwxr-x--x 


图 6-16 


6.4 本章 小 结 


在 本 章 中 ， 我 们 学 习 了 将 持久 性 数据 保存 在 Android 设 备 中 的 不 同方 法 。 对 于 简单 的 非 结构 
化 数据 ， 使 用 SharedPreferences 对 象 是 一 个 理想 的 方案 。 如 果 需 要 存储 批量 数据 ， 可 以 考虑 使 用 
传统 的 文件 系统 。 最 后 ， 对 于 结构 化 数据 ， 在 关系 数据 库 管 理 系 统 中 进行 存储 会 更 有 效率 。 为 
此 ，Android 提 供 了 可 以 利用 公开 的 API 轻 松 访问 的 SQLite 数 据 库 。 

注意 ， 对 于 SharedPreferences 对 象 和 SQLite 数 据 库 来 说 ， 数 据 只 能 被 创建 它 的 应 用 程序 访 
间 。 换 名 话说， 和 它 是 不 可 共享 的 。 如 果 需 要 在 不 同 应 用 程序 之 间 共 吝 数 据 ， 则 要 创建 一 个 内 容 
提供 者 (content providem)。 第 7 章 将 详细 讨论 内 容 提供 者 。 


1. getSharedPreferences() 和 getPreferences() 方 法 的 区 别 是 什么 ? 
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2. ”说 出 能 够 获取 Android 设 备 的 外 部 存储 器 的 路 人 径 的 方法 。 
3. 当 问 外 部 存储 锅 写 入 文件 时 需要 声明 什么 权限 ? 


练习 答案 参见 附录 C。 


本 章 主要 内 容 
to d 关键 概念 
保存 简单 的 用 户 数据 使 用 SharedPreferences 对 象 


在 同一 应 用 程序 的 活动 之 间 共 享 数据 使 用 getSharedPreferences() 方 法 
保存 只 对 创建 它 的 活动 可 见 的 数据 ”使 用 getPreferences() 方 法 


保存 到 文件 使 用 FileOutputStream 和 OutputStreamReader 类 

pe x fL 使 用 FileInputStream 和 和 InputStreamReader 类 

保存 到 外 部 存储 器 使 用 getExternalStorageDirectory() 方 法 返回 指 回 外 部 存储 器 的 路 径 
访问 位 于 res/raw 文 件 夹 下 的 文件 et Resources X] * Qi 过 getResources() 方 法 获得 ) HJopenRawResource() 
创建 数据 库 辅助 类 扩展 SQLiteOpenHelper 类 
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本 章 将 介绍 以 下 内 容 

e 内容 提供 者 简介 

e ”如何 在 Android 中 使 用 内 容 提 供 者 
e ”加 何 创建 自己 的 内 容 提供 者 


如 何 使 用 自己 的 内 容 提 供 者 

在 第 6 章 中 ， 我 们 学 习 了 持久 化 数据 的 不 同方 法 一 一 使 用 共享 首选 项 、 文 件 系统 以 及 SQLite 
数据 库 。 虽 然 使 用 数据 库 方 法 来 保存 结构 化 的 复杂 数据 是 值得 推荐 的 方式 ， 但 数据 共享 是 一 个 
挑战 ， 因 为 数据 库 只 能 被 创建 它 的 包 访 问 。 

我 们 将 在 本 章 学 习 Android 通 过 使 用 内 容 提供 者 来 共享 数据 的 方法 。 您 将 学 习 到 如 何 使 用 内 
置 的 内 容 提 供 者 以 及 通过 实现 自己 的 内 容 提 供 者 来 跨 包 共享 数据 。 


7.1 在 Android 中 共享 数据 


在 Android 中 ， 推 荐 使 用 内 容 提 供 者 来 实现 路 包 的 数据 共享 。 可 以 将 内 容 提供 者 视 为 一 种 数 
据 存 储 。 它 存储 数据 的 方式 和 使 用 它 的 应 用 程序 无 天 ， 重 要 的 是 包 如 何以 一 致 的 编程 接口 来 访 
问 存 储 其 中 的 数据 。 内 容 提供 者 的 行为 方式 与 数据 库 很 像 您 可 以 得 询 它 ， 编 辑 以 及 增加 或 
删除 其 内 容 。 然 而 ， 与 数据 库 不 同 的 是 ， 内 容 提供 者 可 以 使 用 不 同 的 方式 来 存储 数据 。 数 据 可 
以 存储 于 数据 库 、 文 件 中 甚至 网 络 上 。 

Android 附 市 了 许多 有 用 的 内 容 提 供 者 ， 包 括 : 
Browser 一 一 存储 诸如 浏览 疑 书签 、 浏 览 右 历史 记录 等 数据 
CallLog 一 一 存储 诸如 未 接 电 话 、 通 话 详 细 信 息 等 数据 
存储 联系 人 详细 信息 
MediaStore 一 一 存储 媒体 文件 ， 如 音频 、 视 频 和 图 像 

@ Settings 一 一 存储 设备 的 设置 和 首选 项 

除了 一 些 内 置 的 以 外 ， 还 可 以 创建 自己 的 内 容 提 供 者 。 

为 了 答 询 内 容 提 供 者 ， 可 为 特定 行使 用 一 个 可 选 的 说 明 符 ， 以 URI 形 式 指 定 碍 询 字 人 符 串 。 
查询 URI 的 格式 如 下 所 未 : 


Contacts 


«standard prefix»://«authority»/«data path»/«id» 


Moi 2A 


第 7 章 ”内 容 提供 者 


URI 的 个 同 部 分 如 下 所 示 : 
e ”内容 提供 者 的 standard_prefix 始 终 是 content://。 
€ ”authority 指 定 了 内 容 提 供 者 的 名 称 ， 如 内 置 的 Contacts 内 容 提供 者 的 名 称 为 contacts。 对 于 第 三 
方 内 容 提 供 者 ， 将 采用 完全 限定 的 名 称 ， 如 com.wrox.provider 或 者 net.leamn2develop.provider。 
€ data_path 指 定 了 请 求 数据 的 类 型 。 例 如 ， 如 果 您 是 从 Contacts 内 容 提供 者 获取 所 有 联系 人 ， 
Jl data pathi zpeople, r(]URIZjcontent://contacts/people . 
e id 指定 了 请 求 的 特定 记录 。 例 如 ， 如 果 您 从 Contacts 内 容 提 供 者 中 查找 2 与 联系 人 人， 那么 URI 
7jcontent://contacts/people/2 。 
表 7-1 列 出 了 一 些 查 询 字 符 串 的 示例 。 
表 7-1 ”查询 字符 串 的 示例 
EIFE Hoo X 
content://media/internal/images 返回 一 个 存储 在 设备 上 的 所 有 内 部 图 像 的 列表 
content://media/external/images 返回 一 个 存储 在 设备 的 外 部 存储 器 (如 SD 卡 ) 上 的 所 有 图 像 的 列表 


content://call_log/calls 返回 一 个 在 CallLog 中 记录 的 所 有 通话 的 列表 
content://browser/bookmarks 返回 一 个 存储 在 浏览 器 中 的 书签 列表 


7.2 使 用 内 容 提供 者 


理解 内 容 提供 者 的 最 佳 方法 就 是 实际 地 运用 它 。 下 面 的 “ 试 一 试 ”展示 了 在 Android 应 用 各 
序 中 如 何 使 用 内 容 提供 者 。 


"wwe 使 用 Contacts 内 容 提供 者 


Provider.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 控 图 7-1 所 示 创 建 并 命名 一 个 新 的 Android 项 有 目 。 
(2) 在 main.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


«?xml version-"1.0" encoding-"utf-8"?- 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"ftill parent" 
android:layout height-"fill parent" 


«ListView 
android:id-"6-cid/android:list" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1" 
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android:stackFromBottom-"false" 
android:transcriptMode-" "normal" 
/> 

«TextView 
android:id-"((-id/contactName" 
android:textStyle-"bold" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
/? 

«TextView 
android:id-"((-id/contactID" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
/? 


«/LinearLayout» 


New Android Project 
Creates a new Android Project resource. 


Project name: Provider 


Contents 

@ Create new project in workspace 
©) Create project from existing source 
Use default location 


Location; | C/Users/Wer-Meng Lee/Beginning Android/P rovider Browse... 


© Create project from existing sample 


Samples: ApiDemos 
Build Target 


Vendor 


15 
[7] Android 1.6 Android Open Source Project 16 
[7] Google APIs Google Inc. 1.6 
[7] Android 2.1-updatel Android Open Source Project 21l-updatel 
F| Google APIs Google Inc. 21-updatel 
[7] Android 2.2 Android Open Source Project 22 
F| Google APIs Google Inc. 22 
[7] GALAXY Tab Addon Samsung Electronics Co., Ltd. 22 
Android 2.3 Android Open Source Project 23 
C] Google APIs Google Inc. 23 


3 
4 
4 
7 
7 
8 
8 
8 
9 
z] 


pem Android platform 2.3 

Properties 

Application name Provider 

Package name: net.learn2develop.Provider 
W] Create Activity: MainActivity 

Min SDK Version: 9 


218 


第 7 章 ”内 容 提 供 者 


(3) 在 MainActivity.java 类 中 编写 如 下 代码 : 
package net.learn2develop.Provider; 


import android.app.Activity; 


import android.os.Bundle; 


import android.app.ListActivity; 

import android.database.Cursor; 

import android.net.Uri; 

import android.provider.ContactsContract; 
import android.widget.SimpleCursorAdapter; 


public class MainActivity extends ListActivity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 
Uri allContacts - Uri.parse("content://contacts/people"); 
Cursor c = managedQuery(allContacts, null, null, null, null); 


String[] columns = new String[] í( 
ContactsContract.Contacts.DISPLAY NAME, 
ContactsContract.Contacts. ID); 


int[] views = new int[] (R.id.contactName, R.id.contactID]; 


SimpleCursorAdapter adapter = 
new SimpleCursorAdapter(this, R.layout.main, c, columns, views); 
this.setListAdapter (adapter); 


} 
(4) fEAndroidManifest.xml X FP ASIA F TRU S BUR): 


<?xml version-"1.0" encoding-"utf-8"?- 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Provider" 
android:versionCode-"|" 
android:versionName-"1.0"- 
«application android:icon-"8(drawable/icon" android:label-"8string/app name"> 
«activity android:name-".MainActivity" 
android:label-"G8string/app name"» 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 
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«uses-sdk android:minSdkVersion-"7" /> 


«uses-permission android:name-"android.permission.READ CONTACTS"»- 
«/uses-permission» 
«/manifest-» 


(5) 启动 一 个 AVD 并 在 Android 模 拟 器 中 创建 一 些 联系 人 (如 图 7-2 所 示 )。 


& 5554 Android 2.3 Emulator 


x B Ë 2:25 
a Phone-only, unsynced... 


p h. Fm — X wm x D Cw 
i à j [ j ] i 
j m j d E r m 
i | ü I d j Í [E 
" J i ^" | L N F; | 
^. Fi ^. P, E + ^s j 
Au y; 
gu "^ p E 
r - ia, 
j UN o. 
| IJ 4( 
j 
1 / E. 
* d i 一 一 
T. k j 
k | 
b / LM 
TF " 


amas, 


i 一 | Jl L' "E I 1 u | | E ] | - j 
Wel-Meng wu F C. C 


图 7-2 


(6) 按 F11 键 在 Android 醒 拟 器 上 调试 应 用 程序 。 图 7-3 展 示 了 活动 显示 刚刚 创建 的 联系 人 
列表 。 


& 5554: Android 2.3 Emulator 


示例 说 明 


在 这 一 示例 中 ， 检 索 所 有 存储 在 Contacts 应 用 程序 中 的 联系 人 并 在 ListView 中 进行 显示 。 
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Activity 类 的 managedQuery(0) 方 法 检索 一 个 托管 游标 (managed cursor)。 托 管 游标 处 理 在 应 用 
程序 暂停 时 芭 载 其 目 身 和 在 应 用 程序 重 局 时 重新 但 询 目 身 的 所 有 工作 。 
语句 : 


Cursor c — managedQuery(allContacts, null, null, null, null); 
等 价 于 : 


Cursor c — getContentResolver().query(allContacts, null, null, null, null); 
startManagingCursor(c); //--- 人 允许 活动 基于 其 生命 周期 来 管理 游标 的 生命 周期 --- 


getContentResolver() 方 法 返回 一 个 ContentResolver 对 象 ， 它 可 以 使 用 合适 的 内 容 提 供 者 来 帮 
助 解析 内 容 URI。 
SimpleCursorAdapter 对 象 将 一 个 游标 映射 到 在 XML 文件 Anain.xml) 中 定义 的 TextView( 或 者 
ImasgeView)， 并 将 数据 (由 columns 表 示 ) 映 射 到 视 独 (由 views 表 示 ) 上 : 
String[] columns = new String[] { 
ContactsContract.Contacts.DISPLAY NAME, 


ContactsContract.Contacts. ID]; 


int[] views = new int[] í[(R.id.contactName, R.id.contactID!; 


SimpleCursorAdapter adapter = 
new SimpleCursorAdapter(this, R.layout.main, c, columns, views); 
this.setListAdapter (adapter); 


注意 ， 为 了 使 应 用 程序 可 以 访问 Contacts 程 序 ， 需 要 在 AndroidManifest.xml 文 件 中 有 READ - 
CONTACTS 权 限 。 


7.2.1 预定 义 查询 字符 串 常 量 


除了 使 用 查询 URI， 还 可 以 利用 Android 中 的 一 个 预定 义 查询 字符 串 常 量 的 列表 来 为 不 同 数 
据 类 型 指定 URI。 例 如 ， 除 了 使 用 查询 content://contacts/people， 还 可 以 使 用 Android 中 的 一 个 预 
定义 常量 将 以 下 语句 : 

Uri allContacts = Uri.parse("content://contacts/people"); 


Uri allContacts — ContactsContract.Contacts.CONTENT URI; 


注意 : 对 于 Android 2.0 或 更 高 版 本 ， 需 要 使 用 ContactsContract.Contacts. 


CONTENT_URI 这 个 URI 来 查询 基本 的 Contacts 记 录 。 


以 下 是 一 些 预定 义 查 询 字 符 串 常量 的 示例 : 
e Browser. BOOKMARKS URI 


e Browser.SEARCHES URI 
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CallLog.CONTENT URI 
MediaStore.Images.Media.INTERNAL CONTENT URI 
MediaStore.Images.Media.EXTERNAL CONTENT URI 
Setüings.CONTENT URI 

如 果 想 要 检索 第 一 个 联系 人 ， 则 可 按 如 下 方式 指定 此 联系 人 的 ID: 


Uri oneContact = Uri.parse("content://contacts/people/1"); 


sk, n[DZirContentUris2sf]JwithAppendedId() 77 2o fi Hd EN H 28 : 


import android.content.ContentUris; 

risa 

Uri oneContact = ContentUris.withAppendedIid( 
ContactsContract.Contacts.CONTENT URI, 1); 


除了 绑 定 到 ListView， 还 可 以 使 用 Cursor 对 象 将 结果 输出 来 ， 如 下 所 示 : 


package net.learn2develop.Provider; 


import android.app.Activity; 


import android.os.Bundle; 


import android.app.ListActivity; 

import android.database.Cursor; 

import android.net.Uri; 

import android.provider.ContactsContract; 


import android.widget.SimpleCursorAdapter; 
import android.util.Log; 


public class MainActivity extends ListActivity 1 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


Uri allContacts = ContactsContract.Contacts.CONTENT URI; 


Cursor c = managedQuery( 
allContacts, null, null, null, null); 
String[] columns = new String[] { 


ContactsContract.Contacts.DISPLAY NAME, 
ContactsContract.Contacts. ID}; 


int[] views = new int[] í(R.id.contactName, R.id.contactID]); 


SimpleCursorAdapter adapter = 
new SimpleCursorAdapter(this, R.layout.main, 
C, columns, views); 

this.setListAdapter (adapter); 

PrintContacts (o); 
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private void PrintContacts (Cursor c) 
i 
if (c.moveToFirst()) { 
do ( 
String contactID - c.getString(c.getColumnIndex( 
ContactsContract.Contacts. ID)); 
String contactDisplayName = 
c.getString(c.getColumnIndex( 
ContactsContract.Contacts.DISPLAY NAME)); 
Log.v("Content Providers", contactID + ", " + 
contactDisplayName); 


) while (c.moveToNext()); 


) 注意 : 如 果 对 如 何 查看 LogCat 窗 口 不 太 熟 悉 ， 可 参阅 附录 A 快速 了 解 一 下 
Eclipse IDE. 


PrintContacts() 方 法 将 在 LogCat 窗 口中 输出 如 下 内 容 : 


12-13 02:40:36.825: VERBOSE/Content Providers(497): 
l, Wei-Meng Lee 

12-13 02:40:36.825: VERBOSE/Content Providers(497): 
2, Sally Jackson 


它 输出 了 存储 在 Contacts 应 用 程序 中 的 每 一 个 联系 人 的 ID 和 姓名 。 这 时 ， 通 过 访问 
ContactsContract.Contacts. ID 字段 来 获取 联系 人 的 ID， 访 问 ContactsContract.Contacts.DISPLAY _ 
NAME 来 得 到 联系 人 的 姓名 。 如 果 想 显示 联系 人 的 电话 号 个 ， 由 十 这 个 信息 存储 于 男 外 一 张 表 
中 ， 因 此 需要 冉 次 但 询 内 容 提供 者 : 


private void PrintContacts(Cursor c) 
1 
if (c.moveToFirst(í()) I 
do 1 
String contactID = c.getString(c.getColumnIndex( 
ContactsContract.Contacts. ID)); 
String contactDisplayName = 
C.getString(c.getColumnIndex ( 
ContactsContract.Contacts.DISPLAY NAME)); 
Log.v("Content Providers", conLacLEID + ", ”十 
contactDisplayName); 
//--- 获 取 电 话 号 码 --- 
int hasPhone - 
c.getInt(c.getColumnIndex ( 
ContactsContract.Contacts.HAS PHONE NUMBER)); 
if (hasPhone == 1) ( 
Cursor phoneCursor - 


getContentResolver () . query ( 
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ContactsContract.CommonDataKinds.Phone.CONTENT 
URI, null, 
ContactsContract.CommonDataKinds.Phone.CONTACT 
ID + " = ”+ contactID, null, null); 
while (phoneCursor.moveToNext()) I 
Log.v("Content Providers", 
phoneCursor.getString( 
phoneCursor.getColumnIndex ( 
ContactsContract.CommonDataKinds.Phone. 
NUMBER) ) ) ; 
) 
phoneCursor.close(); 
] 


) while (c.moveToNext ()); 


注意 : 为 了 访问 一 个 联系 人 的 电话 号 码 ， 需 要 对 存储 于 ContactsContract. 


CommonDataKinds.Phone.CONTENT URI 中 的 URI 进 行 查询 。 


在 上 面 的 代码 片段 中 ， 首 先 使 用 ContactsContract.Contacts.HAS PHONE NUMBER E EHE; £r— 
个 联系 人 是 否 有 电话 号 伍 。 如 果 其 至 少 有 一 个 电话 号 合 ， 台 可 以 基于 此 联系 人 的 ID 对 内 容 提供 者 
再 次 得 询 。 一 旦 检索 到 这 一 ( 些 ) 号 枉 ， 了 台 可 以 运 代 通 历 并 把 它们 输出 来 。 应 有 如 下 显示 内 容 : 


12-13 02:41:09.541: VERBOSE/Content Providers(546): 
1, Wei-Meng Lee 

12-13 02:41:09.541: VERBOSE/Content Providers(546): 
969-240-65 

12-13 02:41:09.541: VERBOSE/Content Providers(546): 
2, Sally Jackson 

12-13 02:41:09.541: VERBOSE/Content Providers(546): 
345—-668-43 


7.2.2 投影 


managedQuery() 方 法 的 第 2 个 参数 控制 查询 返回 的 列 数 。 这 个 参数 被 称 为 投影 (projection)， 
之 六 是 指定 为 nu]ll: 


Cursor c = managedQuery(í(allContacts, 
null, null, null, null); 


可 以 通过 创建 一 个 包含 需要 返回 的 列 名 的 数组 来 指定 要 返回 的 确切 列 ， 如 下 所 示 : 


String[] projection = new String[| 
[ContactsContract.Contacts. ID, 
ContactsContract.Contacts.DISPLAY NAME, 
ContactsContract.Contacts.HAS PHONE NUMBER]; 

Cursor c — managedQuery(allContacts, projection, 
null, null, null); 
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在 上 述 情况 下 ，_ID、DISPLAY_NAMEL 及 HAS_PHONE_NUMBER 字 上 段 都 将 被 检索 。 


7.2.3 ”筛选 


managedQuery() 方 法 的 第 3 个 和 第 4 个 参数 可 以 用 来 指定 一 个 SQL 的 WHERE 子 句 来 对 查询 结 
朱 进 行 筛选 。 例 如 ， 下 列 语句 只 检索 名 字 以 Lee 结 尾 的 人 : 
Cursor c — managedQuery(allContacts, projection, 


ContactsContract.Contacts.DISPLAY NAME + " LIKE '$Lee'", 
null, null); 


这 里 ， 第 3 个 参数 包含 了 一 个 SQL 语 句 ， 其 中 含有 要 搜索 的 名 字 (Lee)。 还 可 以 将 搜索 字符 串 
放 在 方法 的 第 4 个 参数 中 ， 如 下 所 示 : 
Cursor c = managedQuery(allContacts, projection, 


ContactsContract.Contacts.DISPLAY NAME + " LIKE ?", 
new String[] ["€$Lee") , null); 


7.2.4 排序 


managedQuery() 方 法 的 第 5 个 参数 可 以 用 来 指定 一 个 SQL 的 ORDER BY 子 句 来 对 查询 结果 排 
序 。 例 如 ， 下 列 语句 将 联系 人 名 字 按 升序 进行 排序 : 

Cursor c = managedQuery( 
allContacts, 
projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE ?", 
new String[] {"$"} , 
ContactsContract.Contacts.DISPLAY NAME + " ASC"); 


TERMOYdSRE, MEHDESCX HEF: 


Cursor c = managedQuery( 
allContacts, 
projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE ?", 
new String[] ["S"] , 
ContactsContract.Contacts.DISPLAY NAME + " DESC"); 


7.3 创建 自己 的 内 容 提供 者 


在 Android 中 创建 目 己 的 内 容 提 供 者 非常 测 单 。 所 有 您 
再 要 做 的 是 扩展 抽象 类 ContentProvider， 并 重 与 其 中 定义 
的 各 种 方法 。 

本 市 将 学 习 如 何 创 建 一 个 简单 的 内 容 提 供 者 来 存储 一 
个 图 书 列表 。 为 了 便于 说 明 ， 内 容 提 供 者 将 图 书 存储 在 一 
个 包含 3 个 字段 的 数据 库 表 中 ， 如 图 7-4 所 示 。 

下 面 的 “ 试 一 试 ” 展 示 了 具体 的 操作 步骤 。 
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package net.learn2develop.ContentProviders; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


(1) 打开 Eclipse， 创 : 
ContentProviders 。 

(2) 在 项 目的 src 文 件 夹 下 增加 一 个 新 的 Java 关 文件 ， 并 命 
名 为 BooksProvider.java( 如 图 7-5 所 示 )。 

(3) 按 如 下 所 示 填 充 BooksProvider.java 文 件 : 


android 


android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 


android. 


android 


android. 


ContentProviders.zip 代 码 文 件 可 以 dE Wrox.com.E T 3& 


4 Ee ContentProviders 
4 E src 
4 由 netlearn2develop.ContentProviders 
» | [I] BooksProvider.java 


圭一 个 新 的 Android 项 目 并 命名 为 


> [J] MainActivity.java 
p cn gen [Generated Java Files] 
b BÀ Android 23 
i». assets 
[ e» res 


图 7-5 


.content.ContentProvider; 
content.ContentUris; 
content.ContentValues; 
content.cContext; 
content.UriMatcher; 
database.Cursor; 
database.SQLException; 
database.sqlite.SQLiteDatabase; 
database.sqlite.SQLiteOpenHelper; 
database.sqlite.SQLiteQueryBuilder; 
net.Uri; 

.text.TextUtils; 

util.Log; 


public class BooksProvider extends ContentProvider 


{ 


public static final String PROVIDER NAME — 


"net.learn2develop.provider.Books"; 


public static final Uri CONTENT URI = 
Uri.parse("content://"- PROVIDER NAME + "/books"); 


public static final String ID = " id"; 
public static final String TITLE - "title"; 
public static final String ISBN - "isbn"; 


private static final int BOOKS - 1; 
private static final int BOOK ID = 2; 


private static final UriMatcher uriMatcher; 
staticí 
uriMatcher = new UriMatcher (UriMatcher.NO MATCH); 
uriMatcher.addURI (PROVIDER NAME, "books", BOOKS); 
uriMatcher.addURI (PROVIDER NAME, "books/i", BOOK ID); 


//--- 为 了 使 用 数据 库 --- 


private 
private 
private 
private 


private 


private 


i 
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SQOLiteDatabase booksDB; 

static final String DATABASE NAME = "Books"; 
static final String DATABASE TABLE — "titles"; 
static final int DATABASE VERSION - 1; 

static final String DATABASE CREATE = 

"create table " + DATABASE TABLE + 

" (id integer primary key autoincrement, " 

+ "title text not null, isbn text not null);"; 


static class DatabaseHelper extends SQLiteOpenHelper 


DatabaseHelper (Context context) { 


super(context, DATABASE NAME, null, DATABASE VERSION); 


GOverride 
public void onCreate(SQLiteDatabase db) 


{ 


db.execSQL(DATABASE CREATE); 


Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, 


int newVersion) { 


} 


Log.w ("Content provider database", 
"Upgrading database from version " + 
oldVersion + " to " + newVersion + 
", which will destroy all old data"); 

db.execSQL("DROP TABLE IF EXISTS titles"); 

onCreate (db); 


üOverride 
public int delete(Uri arg0, String argl, String[] arg2) ( 


// arg0 = uri 


// argi 


selection 


// arg2 = selectionArgs 


int count-0; 
switch (uriMatcher.match(argO0))( 


case BOOKS: 
count = booksDB.delete( 
DATABASE TABLE, 
argl, 
arg2); 
break; 
case BOOK ID: 
String id = argÜ.getPathSegments ().get(1); 
count = booksDB.delete( 
DATABASE TABLE, 
ID+"="+ xg 
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(!TextUtils.isEmpty(argl) ? " AND (" + 
argl + ')' : ""), 
arg2); 
break; 
default: throw new IllegalArgumentException ("Unknown URI " + arg0); 
} 
getContext().getContentResolver().notifyChange(argO, null); 


return count; 


QOverride 
public String getType(Uri uri) { 
switch (uriMatcher.match(uri))!í 
//--- 获 取 所 有 图 书 --- 
case BOOKS: 
return "vnd.android.cursor.dir/vnd.learn2develop.books "; 
//--- 获 取 特 定 的 一 本 图 书 --- 
case BOOK ID: 
return "vnd.android.cursor.item/vnd.learn2develop.books "; 
default: 
throw new IllegalArgumentException("Unsupported URI: " + uri); 


GOverride 
public Uri insert (Uri uri, ContentValues values) { 
//--- 添 加 一 本 新 图 书 --- 
long rowID = booksDB.insert( 
DATABASE TABLE, 


nn 
r 


values); 


//--- 如 果 成 功 添加 --- 
if (rowID>0) 


{ 
Uri uri = ContentUris.withAppendedId(CONTENT URI, rowID); 
jeant .getContentResolver ().notifyChange " uri, null); 
return uri; i 
] 
throw new SQLException("Failed to insert row into " + uri); 
} 
QOverride 


public boolean onCreate() I 
Context context - getContext(); 
DatabaseHelper dbHelper - new DatabaseHelper (context); 
booksDB - dbHelper.getWritableDatabase(); 


return (booksDB == null)? false:true; 
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Override 
public Cursor query(Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) { 
SOLiteQueryBuilder sqliBuilder = new SQLiteQueryBuilder(); 
sqlBuilder.setTables (DATABASE TABLE); 


if (uriMatcher.match(uri) == BOOK ID) 
//--- 如 果 是 获取 特定 的 一 本 图 书 --- 
sqlBuilder.appendWhere ( 

_ID +" =" + uri.getPathSegments () . get (1)) ; 


if (sortOrder--null || sortOrder--z"") 
sortOrder - TITLE; 


Cursor c = sqlBuilder.query( 
booksDB, 
projection, 
selection, 
selectionArgs, 
null, 
null, 
sortOrder); 


//--- 注 册 以 便 观察 内 容 URI 的 变化 --- 
c.setNotificationUri (getContext().getContentResolver(), uri); 
return o; 


Override 
public int update(Uri uri, ContentValues values, String selection, 
String[] selectionArgs) { 
int count - 0; 
switch (uriMatcher.match(uri))(í 
case BOOKS: 
count = booksDB.update( 
DATABASE TABLE, 
values, 
selection, 
selectionArgs); 
break; 
case BOOK ID: 
count = booksDB.update( 
DATABASE TABLE, 


values, 

_ID +" =" + uri.getPathSegments().get(1) + 

(!'TextUtils.isEmpty(selection) ? " AND (" + 
selection + ^')' =: ""), 


selectionArgs); 


break; 


default: throw new IllegalArgumentException("Unknown URI " + uri); 
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} 
getContext().getContentResolver().notifyChange(uri, null); 


return count; 


(4) 在 AndroidManifest.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


«?xml version-"1.0" encoding-"utf-8"?-» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.ContentProviders" 
android:versionCode-"]" 
android:versionName-"1].0"- 
«application android:icon-"8(drawable/icon" android:label-"8string/app name"- 
«activity android:name-".MainActivity" 
android:label-"Q8string/app name"» 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" 
/> 
«/intent-filter» 
«/activity» 
«provider android:name-"BooksProvider" 
android:authorities-"net.learn2develop.provider.Books" /» 
«/application» 
«uses-sdk android:minSdkVersion-z"9" /> 


«/manifest» 


示例 说 明 

在 本 例 中 ， 首 先 创 建 一 个 名 为 BooksProvider 的 类 ， 它 扩展 了 ContentProvider 基 类 。 这 个 类 中 
重 写 的 各 个 方法 如 下 所 示 : 

全 ”getType() 一 一 返回 给 定 URI 上 的 数据 的 MIME 类 型 
onCreate() 一 一 当 启 动 提供 者 时 调用 
query() 一 一 接收 客户 端 请 求 ， 结 果 以 Cursor 对 象形 式 返 回 
insert(0 一 一 问 内 容 提供 者 中 揪 入 一 条 新 记录 
delete(0 一 一 从 内 容 提 供 者 中 删除 一 条 现 有 记录 

€ update() 一 一 在 内 容 提 供 者 中 更 新 一 条 现 有 记录 

在 内 容 提 供 者 中 ， 可 以 目 由 选择 如 何 存储 数据 一 一 传统 的 文件 系统 、XML、 数 据 库 或 者 通 
过 Web 服 务 。 本 例 中 ， 使 用 前 一 章 讨论 的 SQLite 数 据 库 方 法 。 

接 独 在 BooksProvider 关 中 定义 以 下 营 量 : 


public static final String PROVIDER NAME = 


"net.learn2develop.provider.Books"; 


public static final Uri CONTENT URI - 
Uri.parse("content://"«- PROVIDER NAME + "/books"); 
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public static final String ID = " id"; 
public static final String TITLE = "title"; 
public static final String ISBN - "isbn"; 


private static final int BOOKS - 1; 
private static final int BOOK ID = 2; 


private static final UriMatcher uriMatcher; 

static 
uriMatcher = new UriMatcher(UriMatcher.NO MATCH); 
uriMatcher.addURI (PROVIDER NAME, "books", BOOKS); 
uriMatcher.addURI (PROVIDER NAME, "books/4", BOOK ID); 


在 上 面 的 代码 中 可 看 到 ， 使 用 一 个 UriMatcher 对 象 来 解 机 通过 一 个 ContentResolver 传 递 给 内 
容 提供 者 的 内 容 URI。 人 例如， 下面 的 内 容 URI 代 表 了 一 个 对 内 容 提 供 者 中 的 所 有 图 书 的 请 求 : 


content://net.learn2develop.provider.Books/books 


下 面 的 内 容 URI 代 表 了 一 个 对 _id 为 5 的 特定 图 书 的 请 求 : 


content://net.learn2develop.provider.MailingList/books/5 


内 容 提供 者 使 用 SQLite 数 据 库存 储 图 书 。 注 意 ， 使 用 SQLiteOpenHelper 辅 助 类 来 协助 管理 数 
据 库 : 


private static class DatabaseHelper extends SQLiteOpenHelper 


1 
DatabaseHelper (Context context) { 
super(context, DATABASE NAME, null, DATABASE VERSION); 
} 
QOverride 
public void onCreate(SQLiteDatabase db) 
{ 
db.execSQL(DATABASE CREATE); 
} 
QOverride 
public void onUpgrade(SQLiteDatabase db, int oldVersion, 
int newVersion) f{ 
Log.w("Content provider database", 
"Upgrading database from version " + 
oldVersion + "to ”二 newVersion + 
", which will destroy all old data"); 
db .execSQL ("DROP TABLE IF EXISTS titles"); 
onCreate(db); 
) 
] 


接 下 来 ， 通 过 重 写 getType() 方 法 来 唯一 地 描述 内 容 提 供 者 的 数据 类 型 。 使 用 UriMatcher 对 
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象 ， 对 于 单 本 图 书 返 回 vnd.android.cursor.item/vnd.learn2develop.books， 对 于 多 本 图 书 返 加 vnd. 
android.cursor.dir/vnd.learn2develop.books: 


QGOverride 
public String getType(Uri uri) { 
switch (uriMatcher.match(uri))(í 
/ / - BUB HB- 
Case BOOKS: 
return "vnd.android.cursor.dir/vnd.learn2develop.books "; 
//--- 获 取 特 定 的 一 本 图 书 ---- 


case BOOK ID: 


return "vnd.android.cursor.item/vnd.learn2develop.books "; 
default: 


throw new IllegalArgumentException("Unsupported URI: " + uri); 


下 一 步 ， 重 写 onCreate() 方 法 以 在 内 容 提 供 者 启动 时 打开 一 个 到 数据 库 的 连接 ; 


QOverride 

public boolean onCreate() { 
Context context = getContext(); 
DatabaseHelper dbHelper - new DatabaseHelper(context); 
booksDB = dbHelper.getWritableDatabase(); 


return (booksDB == null)? false:true; 
] 
3SEU3query0Z; ik. UMIA mí: 
QOverride 


public Cursor query(Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) { 
SOLiteQueryBuilder sqiBuilder = new SQLiteQueryBuilder(); 
sqiBuilder.setTables (DATABASE TABLE); 


if (uriMatcher.match(uri) == BOOK ID) 
//--- 如 果 是 获取 特定 的 一 本 图 书 --- 
sqliBuilder.appendWhere( 
ID +" =" + uri.getPathSegments () .get (1) ); 


if (sortOrder--null || sortOrder--"") 
sortOrder = TITLE; 


Cursor c = sqlBuilder.query( 
booksDB, 
projection, 
selection, 
selectionArgs, 
null, 
null, 


sortOrder); 
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/7V/--- 注 册 以 便 观 察 内 容 URI 的 变化 --- 
c.setNotificationUri (getContext().getContentResolver(), uri); 
return c; 


} 


默认 情况 下 ， 查 询 的 结果 按 title 字 段 进行 排序 。 查 询 结 果 以 Cursor 对 象形 式 返 回 。 
为 了 在 内 容 提 供 者 中 插入 一 本 新 图 书 ， 壳 要 和 曹 写 insert() 方 法 : 
QOverride 
public Uri insert (Uri uri, ContentValues values) { 
/ / -—  BRJU— A38 FS B ———- 
long rowID = booksDB.insert( 
DATABASE TABLE, 


"m v 
F 


values); 


//--- 如 果 成 功 添 加 --- 


if (rowID»0) 


l 
Uri uri = ContentUris.withAppendedId(CONTENT URI, rowID); 
getContext ().getContentResolver().notifyChange( uri, null); 
return uri; 

] 


throw new SQLException("Failed to insert row into " + uri); 


} 
一 且 记 录 被 成 功 插入 ， 则 调用 ContentResolver 的 notifyChange0) 方 法 。 这 将 通知 已 注册 的 观 
察 者 更 新 了 一 行 。 
车 要 删除 一 本 图 书 ， 则 重 写 delete() 方 法 如 下 : 


public int delete (Uri arg0, String argl, String[] arg2) | 
// arg0 = uri 


// argl = selection 


// arg2 = selectionArgs 
int count-0; 
switch (uriMatcher.match(argO0))í 
case BOOKS: 
count = booksDB.delete( 
DATABASE TABLE, 
argl, 
arg2); 
break; 
case BOOK ID: 
String id = argÜ.getPathSegments () .get (1); 
count = booksDB.delete( 
DATABASE TABLE, 
.ABD 4 * e ay ida 
(!TextUtils.isEmpty(argi) ? " AND (" + 
arqt + ty* : UTE. 
argqz]; 
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break; 
default: throw new IllegalArgumentException ("Unknown URI ”二 arg0); 
} 
getContext().getContentResolver().notifyChange(arg0, null); 
return count; 


} 


同样 ， 在 删除 操作 后 要 调用 ContentResolver 的 notifyChange() 方 法 。 这 将 通知 已 注册 的 观察 
者 删除 了 一 行 。 
最 后 ， 若 要 更 新 一 本 图 书 ， 则 重 写 update() 方 法 如 下 : 


QOverride 
public int update(Uri uri, ContentValues values, String selection, 
String[] selectionArgs) 1| 
int count = 0; 
switch (uriMatcher.match(uri))!í 
Case BOOKS: 
count = booksDB.update( 
DATABASE TABLE, 
values, 
selection, 
selectionArgs); 
break; 
case BOOK ID: 
count = booksDB.update( 
DATABASE TABLE, 
values, 
ID +" = " + uri.getPathSegments ().get (1) + 
(!TextUtils.isEmpty(selection) ? " AND (" + 
selection + ')' : ""), 
selectionArgs); 
break; 
default: throw new IllegalArgumentException ("Unknown URI ™ + uri); 
} 
getContextí().getContentResolver().notifyChange(uri, null); 
return count; 


} 
与 insert() 和 delete() 方 法 一 样 ， 在 更 新 后 调用 ContentResolver 的 notifyChange(0) 方 法 。 这 将 通 
知己 注册 的 观察 者 更 新 了 一 行 。 
最 后 ， 为 了 将 内 容 提供 者 注册 到 Android， 可 以 修改 AndroidManifest.xml 文 件 ， 添 加 
<provider> 元 系 。 


使 用 内 容 提供 者 


既然 已 经 构建 了 目 己 的 新 的 内 容 提供 者 ， 那 就 可 以 在 Android 旋 用 程序 中 测试 它 。 和 下面 的 
“ 试 一 试 ”展示 了 是 如 何 做 到 这 一 点 的 。 
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使 用 新 建 的 内 容 提供 者 


(1) 使 用 在 前 一 节 中 所 创建 的 同一 个 项 目 ， 在 main.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 |: 


<23xml|l version-"1.0" encoding-"utfí-8"?- 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android: 
android:layout width-"fill parent" 


android: 


package net.learn2develop.ContentProviders; 


orientation-"vertical" 


layout height-"fill parent" > 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"ISBN" /» 
«EditText 
android:id-"(t-rid/txtISBN" 
android:layout height-"wrap content" 
android:layout width-"ftill parent" /> 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Title" /» 
«EditText 
android:id-"(ktrid/txtTitle" 
android:layout height-"wrap content" 
android:layout width-"ftill parent" /> 
<Button 
android:text-"Add title" 
android:id-"(trid/btnAdd" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 
<Button 
android:text-"Retrieve titles" 
android:id-"(tzid/btnRetrieve" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 
</LinearLayout> 


(2) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


import android.app.Activity; 
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import android.os.Bundle; 


import android.util.Log; 

import android.view.View; 

import android.widget.Button; 

import android.widget.EditText; 
import android.widget.Toast; 

import android.content.ContentValues; 
import android.database.Cursor; 
import android.net.Uri; 


public class MainActivity extends Activity { 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


Button btnAdd = (Button) findViewById(R.id.btnAdd); 
btnAdd.setOnClickListener (new View.OnClickListener() { 
public void onClick(View v) { 
//--- 添 加 一 本 图 书 --- 
ContentValues values = new ContentValues(); 
values.put(BooksProvider.TITLE, ((EditText) 
findViewById(R.id.txtTitle)).getText().toString()); 
values.put(BooksProvider.ISBN, ((EditText) 
f£ndViewByIld (R.id.txtISBN)).getText().toString()); 
Uri uri = getContentResolver().insert( 
BooksProvider.CONTENT URI, values); 
Toast.makeText(getBaseContext(),uri.toString(), 
Toast.LENGTH LONG).show(); 


H): 


Button btnRetrieve = (Button) findViewById(R.id.btnRetrieve); 
btnRetrieve.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) 1 
//--- 检 索 标 题 --- 
Uri allTitles = Uri.parse( 
"content: //net.learn2develop.provider.Books/books"); 
Cursor c = managedQuery(allTitles, null, null, null, 
"title desc"); 
if (c.moveToFirst()) 1 
dot 
Log.v("ContentProviders", 
c.getString(c.getColumnIndex ( 
BooksProvider. ID)) + ", " + 
c.getString(c.getColumnIndex ( 
BooksProvider.TITLE)) + ", " + 
c.getString(c.getColumnIndex |( 
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BooksProvider.ISBN))); 


) while (c.moveToNext()); 


(3) 按 Fl1 键 在 Android 模 拟 侣 上 调试 应 用 程序 。 


(4) 输入 一 本 图 书 的 ISBN 和 标题 并 单 击 Add 按 钮 。 图 7-6 展 示 了 由 Toast 类 显示 添加 到 内 容 提 
供 者 的 图 书 的 URI。 为 了 检索 存储 在 内 容 提 供 者 中 的 所 有 标题 ， 单 击 Retrieve titles 按 钮 并 观察 在 


Eclipse 的 LogCat 窗 口中 所 输出 的 值 。 


示例 说 明 


上 首先 ， 修 改 活动 ， 这 样 用 尸 丈 可 以 答 入 一 本 图 书 的 ISBN 和 标题 来 洪 加 到 刚刚 创建 的 内 容 提 


供 者 中 。 


要 添加 一 本 图 书 到 内 容 提供 者 中 ， 可 以 创建 一 个 新 的 ContentValues 对 象 ， 然 后 用 与 此 图 书 


有 关 的 各 种 信息 来 填充 这 一 对 象 : 


& B55/4 Android 2.3 Emulator c3 LA 


ISBN 


d "e ww 
C) €) CD € 
9780470452622 Edi. d i 
A 
Title a 4 人 一 人 " yr 
due: | "n | a ts, 
Beginning Android 2 Application uM Tan | v 
Development M d 
Ft .s hk. QN X F - 
o D wo 


//--- 添 加 一 本 图 书 ---- 

ContentValues values = new ContentValues(); 

values.put(BooksProvider.TITLE, ((EditText) 
findViewById (R. 1d.txtTitle)).getText () . toString()):; 

values.put(BooksProvider.ISBN, ((EditText) 
tindViewById(R.id.txtISBN)).getText ().toString()); 

Uri uri — getContentResolver().insert( 
BooksProvider.CONTENT URI, values); 


a. 一 


h d ， 


A 
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注意 ， 因 为 内 容 提 供 者 是 在 同一 个 包 中 ， 上 所 以 可 以 分 别 使 用 BooksProvider.TITLE 和 
BooksProvider.ISBN 常 量 来 表示 title 和 isbn 字 段 。 如 果 是 从 男 一 个 包 来 访问 内 容 提 供 者 的 ， 那 么 
将 不 能 够 使 用 这 些 常 量 。 在 那 种 情况 下 ， 需 要 直接 指定 字段 名 称 ， 如 下 所 示 : 


ContentValues values = new ContentValues(); 
values.put("title", ((EditText) 
findViewById(R.id.txtTitle)).getText ().toString());: 
values.put("isbn", ((EditText) 
findViewById (R.id.txtISBN)).getText ().toString()); 
Uri uri = getContentResolver().insert( 
Uri.parse( 
"content: //net.learn2develop.provider.Books/books"), 
values); 
Toast.makeText(getBaseContext (),uri.toString(), 


Toast.LENGTH LONG).show(); 


男 外 还 要 注意 ， 对 于 外 部 包 ， 需 要 使 用 完全 限定 的 名 称 来 引用 内 容 URI: 


Uri.parsel 
"content://net.learn?develop.provider.Books/books"), 


要 检索 内 容 提供 者 中 的 所 有 标题 ， 可 使 用 下 面 的 代码 片段 : 


Uri allTitles = Uri.parse( 
"cContent://net.learn2develop.provider.Books/books"); 


Cursor c = managedQuery(allTitles, null, null, null, 
"title desc"); 
if (c.moveToFirst()) { 
do | 
Log.v("ContentProviders", 
Cc.getString(c.getColumnIndex( 
BooksProvider. ID)) + ", " + 
c.getString(c.getColumnIndex ( 
BooksProvider.TITLE)) + ", "+4 
c.getString(c.getColumnIndex ( 
BooksProvider.ISBN))); 
) while (c.moveToNext ()); 


} 


前 面 的 查询 将 返回 按 title 字 段 降序 排列 的 结果 。 
如 果 想 更 新 一 本 图 书 的 详细 信息 ， 调 用 update() 方 法 ， 使 用 内 容 URI 来 指示 图 书 的 ID， 


ContentValues editedValues = new ContentValues(); 
editedValues.put(BooksProvider.TITLE, "Android Tips and Tricks"); 
getContentResolver().update( 

Uri.parse( 

"Content://net.learn2develop.provider.Books/books/2"), 

editedValues, 

null, 

null); 
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要 删除 一 本 图 书 ， 调 用 delete0) 方 法 ， 使 用 内 容 URI 来 指示 图 书 的 ID: 


getContentResolver().delete( 
Uri.parse("content://net.learn2develop.provider.Books/books/2"), 
null, null); 


要 删除 所 有 图 书 ， 只 要 在 内 容 URI 中 省 略图 书 的 ID: 


getContentResolver ().delete( 
Uri.parse("content://net.learn2develop.provider.Books/books"), 
null, null); 


7.4 ”本章 小 结 


在 这 一 章 中 ， 我 们 了 解 了 什么 是 内 容 提 供 者 ， 以 及 如 何 使 用 一 些 内 置 在 Android 中 的 内 容 提 
供 者 。 特 别 是 ， 我 们 学 习 了 如 何 使 用 Contacts 内 容 提 供 者 。Google 做 出 的 提供 内 容 提 供 者 的 决定 
使 得 应 用 程序 可 以 通过 一 套 标 准 的 编程 接口 进行 数据 共享 。 除 了 内 置 的 内 容 提供 者 以 外 ， 还 可 
以 由 日 己 创建 自 定 义 的 内 容 提供 者 来 与 其 他 包 实 现 数据 共 至 。 


1.  ” 写 一 个 查询 ， 实 现 从 Contacts 应 用 程序 中 检索 所 有 包含 单词 jack 的 联系 人 。 
2. ”说 出 在 实现 自己 的 内 容 提供 者 时 必须 重 写 的 方法 。 
3. ”如 何在 AndroidManifest.xml 文 件 中 注册 一 个 内 容 提 供 者 ? 


练习 答案 参见 附录 C。 


本 章 主要 内 容 


主 a 关键 概念 

检索 一 个 托管 游标 使 用 managedQuery() 方 法 

为 内 容 提 供 者 指定 查询 的 两 种 方法 使 用 但 询 URI 或 者 预定 义 查 询 字 符 串 常量 

在 一 个 内 容 提 供 者 中 检索 一 列 的 值 使 用 getColumnIndex() 方 法 

访问 联系 人 姓名 所 用 的 码 询 URI ContactsContract.Contacts.CONTENT_URI 

访问 联系 人 电话 号 码 所 用 的 香 询 URI ContactsContract.CommonDataKinds.Phone.CONTENT_URI 
创建 自己 的 内 容 提供 者 创建 一 个 扩展 ContentProvider 类 的 类 
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本 章 将 介绍 以 下 内 容 
如 何以 编程 方式 通过 应 用 程序 发 送 SMS 消 县 
如 何 使 用 内 置 的 Messaging 应 用 程序 发 送 SMS 消 息 
如 何 接收 传 入 的 SMS 消 息 
如 何 通 过 应 用 程序 发 送 电 子 邮 件 消息 
如 何 使 用 HTTP 连 接 到 Web 

e 如 何 使 用 Web 服 务 

一 旦 局 动 并 运行 基本 的 Android 必 用 程序 ， 下 一 个 有 趣 的 事情 就 是 为 其 请 加 与 外 界 通信 的 能 
力 。 您 可 能 硕 望 在 一 件 事情 发 生 ( 如 您 到 达 了 一 个 特定 的 地 理 位 置 ) 时 应 用 程序 可 以 给 另 一 部 手机 
上 发 运 SMS 消 县 ， 或 者 可 能 希望 访问 一 个 提供 特定 服务 (如 汇率 、 天 气 等 ) 的 Web 服 务 。 

在 本 章 中 ， 将 学 习 如 何以 编程 方式 从 Android 应 用 程序 中 发 送 和 接收 SMS 消 息 。 

还 将 学 习 如 何 使 用 HTTP 协 议 来 与 Web 服 务 器 对话， 从 而 可 以 下 载 文 本 和 二 进 制 数 据 。 本 草 
的 最 后 部 分 将 介绍 如 何 解析 XML 文件 来 提取 一 个 XML 文件 的 相关 部 分 一 一 这 是 访问 Web 服 务 时 
很 有 用 的 一 种 技术 。 


8.1 SMS 消 息 传 递 


SMS 消 息 传 递 是 当今 手机 上 的 一 个 主要 的 杀手 级 应 用 一 一 对 于 一 些 用 户 来 说 ， 这 跟 手 机 本 
身 一 样 必 不 可 少 。 当 前 您 购买 的 任何 手机 都 至 少 应 该 具有 SMS 消 息 传 递 的 功能 ， 几 乎 所 有 年 龄 
段 的 用 户 都 知道 如 何 发 送 和 接收 这 类 消息 。Android 带 有 一 个 内 置 的 SMS 应 用 程序 ， 可 以 接收 和 
发 送 SMS 消 息 。 不 过 ， 在 某 些 情况 下 ， 您 可 能 想 要 将 SMS 功 能 集成 到 您 自己 的 应 用 程序 中 。 举 
个 例子 ， 您 也 许 打算 写 一 个 能 够 按 固定 时 间 间 隔 自 动 发 送 SMS 消 息 的 应 用 程序 。 例 如 ， 您 想 追 
踪 孩 子 的 位 置 时 这 就 非常 有 用 一 一 只 要 给 他 们 一 个 Android 设 备 ， 可 以 每 30 分 钟 发 出 一 条 包含 地 
理 位 置信 息 的 SMS 消 县 就 行 了 。 这 下 ， 您 就 对 他 们 放 了 学 是 否 真 的 去 了 图 书馆 了 解 得 一 清二 楚 
(当然 ， 这 也 意味 大 您 不 得 不 为 发 送 这 类 短信 而 人 破 点 费 )。 

本 节 介 绍 如 何在 Android 应 用 程序 中 以 编程 方式 上 发送 和 接收 SMS 消 息 。 对 Android 开 发 人 员 来 
说 ， 好 消息 是 不 需要 用 一 个 真正 的 设备 来 对 SMS 消 息 传 递 进 行 测试 : 免费 的 Android 模 拟 器 提供 
了 这 一 功能 。 


a2" "7 X X *" 
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8.1.1 以 编程 方式 发 送 SMS 消 息 


首先 ， 您 将 学 习 如 何以 编程 方式 通过 应 用 程序 发 送 SMS 消 息 。 使 用 这 种 方法 ， 应 用 程序 可 
以 上 自动 发 送 短信 给 收 件 人 ， 而 无 须 用 户 和 干预。 下面 的 “ 试 一 试 ” 将 告诉 您 这 是 如 何 做 到 的 。 


发 送 SMS 消 息 
SMS.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 按 图 8-1 所 示 创 建 一 个 新 的 Android 项 上 月 。 


|| New Android Project 
Creates a new Android Project resource. 


Project name | SMS 

Contents 

@ Create new project in workspace 
© Create project from existing source 
[7] Use default location 


Location: | Cx Users/Wei-Meng Lee/Beginning Android/SMS 


© Create project from existing sample 


Samples: | ApiDemos 


Build Target 


| Target Name Vendor Platform 
[7] Android 2.1-updatel Android Open Source Project 21-upda... 
[^] Google APIs Google Inc. 21-upda.. 
[7] Android 2.2 Android Open Source Project 242 

E| Google APIs Google Inc. 22 

[^] GALAXY Tab Addon Samsung Electronics Co., Ltd. 24 

| Android 2.3 Android Open Source Project 23 

[^] Google APIs Google Inc. 23 


Properties 
Application name: SMS 
Package name: net.learn2develop.5MS 


Create Activity; ^ MainActivity 
Min SDK Version — 9 


图 8-1 
(2) 在 main.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


«?xml version-"1.0" encoding-"utfí-8"?-» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
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«Button 
android:id-"(ü(-xid/btnSendSMS" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Send SMS" /» 


«/LinearLayout» 


(3) 在 AndroidManifest.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?- 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.sSMS" 
android:versionCode-"]|" 
android:versionName-"1.0"-» 
«application android:icon-"8drawable/icon" android:label-"8string/app name"> 
«activity android:name-".MainActivity" 
android:label-"G8string/app name"» 
«intent-hHilter- 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"8" /> 
«uses-permission android:name-"android.permission. SEND SMS'"»«/ uses-permission^ 
«/manifest-» 


package net.learn2develop.SMS5; 


import android.app.Activity; 


import android.os.Bundle; 


import android.app.PendingIntent; 
import android.content.Intent; 
import android.telephony.SmsManager; 
import android.view.View; 


import android.widget.Button; 


public class MainActivity extends Activity I 
Button btnSendSM5; 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


btnSendSMS = (Button) fidViewByIld(R.id.btnSendSM5); 
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btnSendSMS.setOnClickListener (new View.OnClickListener() 


{ 
public void onClick(View v) 
t 
sendSMS("5556", "Hello my friends!"); 
} 
h; 


//--- 发 送 一 条 短信 到 另 一 个 设备 --- 
private void sendSMS(String phoneNumber, String message) 


{ 
SmsManager sms = SmsManager.getDefault(); 
sms.sendTextMessage(phoneNumber, null, message, null, null); 


(5) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 使 用 Android SDK and AVD Managerji z/ 7j 
一 个 AVD。 

(6) 在 第 1 个 Android 模 拟 器 上 ， 单 击 Send SMS 按 钮 来 发 送 SMS 消 息 到 第 2 个 模拟 器 。 图 8-2(a) 
展示 了 由 第 2 个 模拟 需 收 到 的 SMS 消 上 息 ( 广 意 在 第 2 个 模拟 器 项 痪 的 通知 栏 )。 


" 5555:8oogleAFIs 27.2 Emulator 


| Eb 5554: Hello my friends! 


Sea all your apps. 
Touch the Launcher icon. 


(b) 


示例 说 明 

Android 使 用 基于 权限 的 策略 ， 因 此 应 用 程序 所 需 的 所 有 权限 都 必须 在 AndroidManifest.xml 
文件 中 指定 。 这 可 以 确保 在 应 用 程序 安装 时 ， 用 户 确切 地 知道 它 需要 哪些 访问 权限 。 

由 于 发 送 SMS 消 县 会 导致 用 户 的 额外 费用 ， 因 此 在 AndroidManifest.xml 文 件 中 指明 SMS 权 
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使 用 SmsManager 类 ， 可 以 以 编程 方式 来 发 送 SMS 消 息 。 与 其 他 类 不 同 ， 不 能 直接 
实例 化 这 个 类 ， 而 是 要 调用 getDefaultO 静 态 方 法 获得 一 个 SmsManager 对 象 。 然 后 ， 使 用 
sendTextMessage() TEK / XS SMS 1H W: 
private void sendSMS(String phoneNumber, String message) 
{ 
SmsManager sms = SmsManager.getDefaultí(); 


sms.sendTextMessage(phoneNumber, null, message, null, null); 


} 


以 下 是 sendTextMessage() 方 法 用 到 的 5 个 参数 : 


€ destinationAddress 收 件 人 的 电话 号 人 码 

€ ”scAddress 一 一 服务 中 心地 址 ，null 代 表 默 认 的 SMSC 

€ text 一 一 SMS 消 明 的 内 容 

€ sentIntent 一 一 发 送 消 奶 后 调用 的 挂 起 的 意图 (8.1.2 节 将 详细 讨论 ) 
€ deliveryIntent 一 一 消 奶 递送 后 调用 的 挂 起 的 意图 (8.1.2 节 详细 讨论 ) 


8.1.2 ”发送 消息 后 获取 反馈 


8.1.1 玫 学 习 了 如 何 使 用 SmsManager 关 以 编程 方式 发 送 SMS 消 县 ， 但 如 何 知道 消息 已 被 正确 
RIZ T H? 要 达到 此 目的 ， 可 以 创建 两 个 PendingIntent 对 象 来 监视 SMS 消 息 皮 送 过 程 中 的 状态 。 
这 两 个 PendingIntent 对 象 传递 给 sendTextMessage() 方 法 的 最 后 两 个 参数 。 下 面 的 代码 片段 展示 了 
如 何 监视 被 发 送 的 SMS 消 息 的 状态 : 


/V/--- 发 送 一 条 SMS 消 息 到 另 一 个 设备 ---- 
private void sendSMS(String phoneNumber, String message) 
{ 

String SENT = "SMS SENT"; 

String DELIVERED — "SMS DELIVERED"; 


PendingIntent sentPI = PendingIntent.getBroadcast(this, O0, 
new Intent(SENT), 0); 


PendingIntent deliveredPI = PendingIntent.getBroadcast(this, O0, 
new Intent(DELIVERED), 0); 


//--- 当 SMS 消 息 已 被 发 送 时 --- 
registerReceiver(new BroadcastReceiver () { 
Override 
public void onReceive (Context arg0, Intent argl) { 
switch (getResultCode () ) 
i 
case Activity.RESULT OK: 
Toast.makeText(getBaseContext(), "SMS sent", 
Toast.LENGTH SHORT).show(); 


break; 
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case SmsManager.RESULT ERROR GENERIC FAILURE: 
Toast.makeText(getBaseContext(), "Generic failure", 
Toast.LENGTH SHORT).show(); 
break; 
case SmsManager.RESULT ERROR NO SERVICE: 
Toast.makeText(getBaseContext(), "No service", 
Toast.LENGTH SHORT).show(); 
break; 
case SmsManager.RESULT ERROR NULL PDU: 
Toast.makeText(getBaseContext(), "Null PDU", 
Toast.LENGTH SHORT).show(); 
break; 
case SmsManager.RESULT ERROR RADIO OFF: 
Toast.makeText(getBaseContext(), "Radio off", 
Toast.LENGTH SHORT).show(); 


break; 


} 
), new IntentFilter (SENI) ) ， 


//--- 当 SMS 消 息 已 被 递送 时 --- 
registerReceiver (new BroadcastReceiver ()í 
GOverride 
public void onReceive(Context arg0, Intent argl1) 1 
switch (getResultCode()) 
{ 
case Activity.RESULT OK: 
Toast.makeText(getBaseContext(), "SMS delivered", 
Toast.LENGTH SHORT).show(); 
break; 
case Activity.RESULT CANCELED: 
Toast.makeText(getBaseContext(), "SMS not delivered", 
Toast.LENGTH SHORT).show(); 


break; 


} 
), new IntentFilter (DELIVERED)); 


SmsManager sms = SmsManager.getDefault(); 
sms.sendTextMessage (phoneNumber, null, message, sentPI, deliveredPI); 
} 

在 这 里 ， 创 建 了 两 个 PendingIntent 对 象 。 然 后 ， 为 两 个 BroadcastReceiver 进 行 注册 。 这 两 个 
BroadcastReceiver 侦 听 与 SMS_SENT 和 SMS_DELIVERED 匹 配 的 意图 (分 别 在 发 送 和 接收 消息 后 
由 操作 系统 触发 )。 在 每 一 个 BroadcastReceiver 中 ， 重 写 onReceive() 方 法 并 得 到 当前 的 结果 但 。 

两 个 PendingIntent 对 象 被 传递 给 sendTextMessasge(0) 方 法 的 最 后 两 个 参数 : 

sms.sendTextMessage (phoneNumber, null, message, sentPI, deliveredPI); 

在 这 种 情况 下 ， 无 论 消息 是 被 正确 发 送 还 是 递送 失败 ， 都 将 通过 这 两 个 PendingIntent 对 象 来 
通知 您 其 状态 。 
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8.1.3 使 用 意图 发 送 SMS 消 息 


使 用 SmsManager 类 ， 可 以 通过 应 用 程序 发 送 SMS 消 息 ， 而 不 需要 涉及 内 置 的 Messaging 应 用 
程序 。 但 有 时 候 ， 如 果 可 以 直接 调用 内 置 的 Messaging 应 用 程序 并 让 它 做 发 送 消息 的 所 有 工作 ， 
发 送 SMS 消 有 息 会 变 得 更 容易 些 

要 在 应 用 程序 中 激活 内 置 的 Messaging 应 用 程序 ， 可 以 使 用 一 个 具有 MIME 类 型 vnd.android- 
dirmms-sms 的 Intent 对 象 ， 如 下 面 的 代 但 片段 所 未 : 

/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


setContentView (R.layout.main); 


btnSendSMS = (Button) findViewById (R.id.btnSendSM353); 
btnSendSMS.setOnClickListener(new View.OnClickListener() 


{ 
public void onClick(View v) 
{ 
//sendSMS("5556", "Hello my friends!"); 
Intent i = new 
Intent(android.content.Intent.ACTION VIEW); 
i.putExtra("address", "5556; 5558; 5560"); 


i.putExtra("sms body", "Hello my friends!"); 
i.setType ("vnd.android-dir/mms-sms"); 
startActivity (i); 


)); 
] 


这 将 调用 Messaging 应 用 程序 ， 如 图 8-3 所 示 。 注 意 ， 可 以 发 送 SMS 给 多 个 收 件 人 ， 只 需要 用 
(在 PutExtra(0) 方 法 中 ) 分 号 分 隔 每 个 电话 号 但 就 行 了 。 


(4 5554Android_22_Emulator 


252b, 25560, 2558 
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图 8-3 
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注意 : 如 果 使 用 这 个 方法 来 调用 Messaging 应 用 程序 ， 就 没有 必要 在 
AndroidManifest.xml X £F P 48: SMS SEND 权限， 因为 您 的 应 用 程序 并 非 是 最 
终 发 送 PP 息 的 那个 。 


8.1.4 接收 SMS 消 息 


除了 从 Android 应 用 程序 发 送 SMS 消 息 外 ， 还 可 以 在 应 用 程序 中 使 用 BroadcastReceiver 对 象 
接收 传 入 的 SMS 消 息 。 如 果 和 希望 应 用 程序 在 收 到 一 条 特定 的 SMS 消 县 时 执行 一 个 动作 ， 这 就 很 
有 用 了 。 例 如 ， 您 可 能 想 妃 踪 您 的 手机 位 置 以 防 丢 失 或 被 资 。 在 这 种 情况 下 ， 可 以 编写 一 个 应 
用 程序 ， 用 来 自动 侦 听 包含 一 些 秘密 代码 的 SMS 消 息 。 一 旦 收 到 此 类 信息 ， 就 可 以 给 发 送 者 发 
器 一 条 包含 位 置 坐 标的 SMS 消 奶 。 

下 面 的 “ 试 一 试 ” 展 示 了 如 何以 编程 方式 侦 听 传 入 的 SMS 消 息 。 


接收 SMS 消 息 


(1) 使 用 在 8.1.3 节 所 创建 的 同一 个 项 目 ， 在 AndroidManifest.xml 文 件 中 添加 下 列 粗 体 显示 的 
iB: 


«?xml version-"1.0" encoding-"utf-8"?-» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.SMS" 
android:versionCode-"]" 
android:versionName-"1.0"- 
«application android:icon-"8(drawable/icon" android:label-"8string/app name" 
«activity android:name-".MainActivity" 
android:label-"Qstring/app name"- 
«intent-tilter- 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«receiver android:name-".SMSReceiver'- 
«intent-filter» 
«action android:name- 
"android.provider.Telephony.SMS RECEIVED" /> 
</intent-filter> 
«/receiver» 
«/application» 
«uses-sdk android:minSdkVersion-"8" /» 
«uses-permission android:name-"android.permission.SEND SMS"»«/uses-permission» 
€«uses-permission android:name-"android.permission.RECEIVE SMS"» 
«/uses-permission» 
«/manifest-» 
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(2) 在 项 目的 src 文 件 夹 中 ， 在 包 名 下 增加 一 个 新 的 类 文件 ， 
全 名 为 SMSReceiver.java( 如 图 8-4 所 示 )。 
(3) 按 如 下 所 示 编 写 SMSReceiver.java 文 件 : 


package net.learn2develop.SMS; 


并 


4 E 5M5 
4 $8 src 
4 (所 netlearn2develop.SMS 
; [Ù MainActivity.java 


» (I) SMSReceiver java 
b E gen [Generated Java Files] 


b mà Android 22 
import android.content.BroadcastReceiver; rasis 
import android.content.Context; E] 8-4 
import android.content.Intent; 
import android.os.Bundle; 
import android.telephony.SmsMessage; 
import android.widget.Toast; 
public class SMSReceiver extends BroadcastReceiver 
{ 
QGOverride 
public void onReceive(Context context, Intent intent) 
i 
//--- 获 取 传 入 的 SMS 消 息 --- 
Bundle bundle - intent.getExtras(); 
SmsMessage[] msgs = null; 
String str = ""; 
if (bundle != null) 
{ 
//--- 检 索 接 收 到 的 SMS 消 息 --- 
Object[] pdus = (Object[]) bundle.get("pdus"); 
msgs — new SmsMessage[pdus.length]; 
for (int i-0; ic«msgs.length; i++){ 
msgs[i] = SmsMessage.createFromPdu((byte[])pdus[il); 
str += "SMS from " + msgs[i].getOriginatingAddress(); 
str 二 一 " :"; 
str += msgs[i].getMessageBody().toString(); 
str += "Mn"; 
] 
//--- 显 示 新 的 SMS 消 息 --- 
Toast.makeText(context, str, Toast.LENGTH SHORT).show(); 
) | 3ndraid 22 Emulator 一 一 
5 
) E (651234567: Hello from DOMS! 


(4) 按 Fl1 键 在 Android 模 拟 器 上 调 

(5) 使 用 DDMS， 给 模拟 器 发 送 一 
条 消息 。 应 用 程序 将 能 够 接收 到 这 条 
消息 并 用 Toast 类 进行 显示 (如 图 8-5 
所 示 )。 


示例 说 明 
要 侦 听 传 入 的 SMS 消 息 ， 需 要 创建 


SMS from 1234567 Hello from DDMSI 
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一 个 BroadcastReceiver 类 。BroadcastReceiver 类 使 应 用 程序 接收 其 他 应 用 程序 使 用 sendBroadcastO) 
方法 发 送 的 意图 。 从 本 质 上 讲 ， 它 使 您 的 应 用 程序 可 以 处 理由 其 他 程序 应 用 所 引发 的 事件 。 当 
接收 到 一 个 意图 对 象 时 ， 调 用 onReceive0 方 法 。 因 此 ， 需 要 重 写 这 一 方法 。 

onReceive() 77 1: YE M $8] — Fe AL SMS B EINST df 7. SMS TH OB IE— T BundleX] $8, 
在 Intent 对 象 ( 即 意图 ;， onReceive0Z;j 1k] 28 AS. 3H ALEAPDURIE EE 4 Objectzdt £H 
Fo HIEREN, o EH SmsMessage# MEt N iXcreateFromPdu(), Ja fit Hl Toast% © 
ZRSMSHE. RIFA WHE S hatan 法 来 获得 ， 因 此 如 果 需 要 给 发 送 
者 发 一 个 目 动 回复 ， 就 可 以 使 用 该 方法 获得 发 送 者 的 电话 号 

BroadcastReceiver 有 一 个 有 趣 的 特性 : 即使 应 用 enki ， 您 也 可 以 继续 侦 听 传 入 的 
SMS 消 县 ;只 要 应 用 程序 已 经 安 疼 在 设备 上 上， 任何 传 入 的 SMS 消 县 都 将 被 该 应 用 程序 所 接收 。 


1. 通过 BroadcastReceiver 更 新 一 个 活动 


上 一 节 介 绍 了 如 何 使 用 一 个 BroadcastReceivefr 类 侦 听 传人 入 的 SMS 消 息 ， 然 后 使 用 Toast 类 来 
显示 接收 到 的 消息 。 通 常情 况 下， 您 想 要 将 SMS 消 明 发 回 给 应 用 程序 的 主 活动 。 例 如 ， 您 可 能 
希望 消 居 在 一 个 TextView 中 显示 。 下 和 面 的 “ 试 一 试 ” 将 告诉 您 如 何 做 到 这 一 点 。 


创建 一 个 基于 视图 的 应 用 程序 项 目 


(1) 使 用 在 8.1.3 节 所 创建 的 同一 个 项 目 ， 在 main.xzml 文 件 中 添加 下 列 粗 体 显示 的 行 : 


<?xml version-"1.0" encoding-"utf-8"?- 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


«Button 
android:id-"8-cid/btnSendSMSs" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Send SMS" /> 


«TextView 
android:id-"(trid/textViewl" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 
</LinearLayout> 
(2) 在 SMSReceiver.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
package net.learn2develop.SMS; 


import android.content.BroadcastHeceiver; 
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android. 
android. 
android. 
android. 


android. 


conLtent.Context; 
content.Intent; 
os.Bundle; 
telephony.SmsMessage; 


widget.Toast; 


public class SMSReceiver extends BroadcastReceiver 
{ 

QOverride 

public void onReceive(Context context, 


{ 


Intent intent) 


//--- 获 取 传 入 的 SMS 消 息 --- 
Bundle bundle = intent.getExtras(); 
SmsMessage[] msgs = null; 
String str = ""; 
if (bundle !- null) 
{ 
//--- 检 索 接 收 到 的 SMS 消 息 --- 
Object[] pdus = (Object[]) bundle.get("pdus"); 
msgs = new SmsMessage[pdus.length]|; 
for (int i-0; i«msgs.length; i++){ 
msgs[i] = SmsMessage.createFromPdu((byte[])pdus[il);: 
str += "SMS from " + msgs[i].getOriginatingAddress();: 
str qo ™ "S 
str += msgs[i].getMessageBody () .toString(); 
str += "Xn": 
} 
//--- 显 示 新 的 SMS 消 息 --- 
Toast.makeText(context, str, Toast.LENGTH SHORT).show(); 


//--- 发 送 一 个 广播 意图 来 更 新 活动 中 接收 到 的 SMS--- 

Intent broadcastlIntent = new Intent(); 
broadcastintent.setAction("SMS RECEIVED ACTION"); 
str); 


context.sendBroadcast(broadcastIntent); 


broadcastIntent.putExtra("sms", 


(3) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
package net.learn2develop.SMS; 


import android.app.Activity; 


import android.os.Bundle; 
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import 
import 
import 


import 


android. 
android. 
android. 


android. 


app.PendingIntent; 
content.Context; 
content.Intent;j 


telephony.SmsManager; 
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import android.view.View; 
import android.widget.Button; 


import android.widget.Toast; 


import android.content.BroadcastReceiver; 
import android.content.IntentFilter; 
import android.widget.TextView; 


public class MainActivity extends Activity I 
Button btnSendSMS; 
IntentFilter intentFilter; 


private BroadcastReceiver intentReceiver = new BroadcastReceiver() { 
Override 
public void onReceive(Context context, Intent intent) { 
//--- 在 TextView 中 显示 收 到 的 SMS--- 
TextView SMSes = (TextView) findViewById (R.id.textViewl); 
SMSes.setText(intent.getExtras().getString("sms")); 


Ri 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

aOverride 

public void onCreate(Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//--- 用 来 筛选 sMs 消 息 已 接收 的 意图 --- 


intentFilter - new IntentFilter(); 
intentFilter.addAction("SMS RECEIVED ACTION"); 


btnSendSMS = (Button) findViewById (R.id.btnSendSM53); 
btnSendSMS.setOnClickListener(new View.OnClickListener() 
| 
public void onClick(View v) 
i 
//sendSMS("5554", "Hello my friends!"); 


Intent i = new 

Intent (android.content.Intent.ACTION VIEW); 
i.putExtra("address", "5556; 5558; 5560"); 
i.putExtra("sms body", "Hello my friends!"); 
i.setType ("vnd.android-dir/mms-sms"); 


startActivity(i); 


)); 


üOverride 


protected void onResume() { 
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//--- 注 册 接 收 者 --- 
registerReceiver(intentReceiver, intentFilter); 


super.onResume(); 


Override 
protected void onPause() { 


//--- 注 销 接收 者 --- 
unregisterReceiver (intentReceiver); 
super.onPause(); 


} 


//--- 发 送 一 条 SMS 消 息 到 另 一 个 设备 --- 


private void sendSMS(String phoneNumber, String message) 
1 
ETT 


(4) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 使 用 DDMS 疝 模拟 器 发 送 一 条 SMS 消 息 。 图 
8-6 展 示 丁 分 别 由 Toast 类 和 TextView 所 显示 的 收 到 的 消 轧 。 


'W 535&Andreid 2.2 Emulator 


= *651234587: Hello from DDMS 


x1 | | E 


Send SMS 


5MS from 1234567 :Hello from DDMS! 


5M5 from 1234557 :Hello from DDMS! 


示例 说 明 

首先 在 活动 中 添加 一 个 TextView， 可 以 用 它 来 显示 接收 到 的 SMS 消 息 。 

接 下 来 修改 SMSReceiver 类 。 这 样 当 它 接收 到 一 条 SMS 消 息 时 ， 将 广播 另 一 个 Intent 对 象 ， 
使 得 侦 听 这 一 意图 的 任何 应 用 程序 可 以 得 到 通知 (我 们 接 下 来 将 在 活动 中 实现 )。 收 到 的 SMS 也 将 
通过 这 个 意图 发 送出 去 。 

//--- 发 送 一 个 广 提 


意图 来 更 新 活动 中 接收 到 的 SMS--- 
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Intent broadcastIntent = new Intent(); 
broadcastIntent.setAction("SMS8 RECEIVED ACTION"); 
broadcastIntent.putExtra("sms", str); 


context.sendBroadcast(broadcastIntent); 


Fi, dX) —^'BroadcastReceiverX] 5: x [pir] 38 3s 41: 


private BroadcastReceiver intentReceiver = new BroadcastReceiver() { 
QOverride 
public void onReceive(Context context, Intent intent) [| 
//--- 在 TextView 中 显示 收 到 的 SMS--- 
TextView SMSes = (TextView) findViewById(R.id.textViewl); 
SMSes.setText(intent.getExtras().getString("sms")); 


当 收 到 一 个 广播 意图 时 ， 更 新 TextView 中 的 SMS 消 居 。 
您 需要 创建 一 个 IntentFilter 对 销 以 便 侦 听 一 个 特定 的 总 图。 这 里 ， 意 图 是 SMS_RECEIVED_ 
ACTION: 
QGOverride 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//--- 用 来 筛选 sMs 消 息 已 接收 的 意图 --- 
intentFilter = new IntentFilter(); 


intentFilter.addAction("SMS RECEIVED ACTION"); 
PI PE 


最 后 ， 在 活动 的 onResume0O 事 件 中 注册 BroadcastReceiver， 在 onPause0 事 件 中 进行 注销 : 


QOverride 

protected void onResume() 1{ 
//--- 注 册 接收 者 --- 
registerReceiver(intentReceiver, intentFilter); 


super.onResume (); 


GOverride 
protected void onPause() { 
//--- 注 宵 接 收 者 --- 
unregisterReceiver (intentReceiver); 


super.onPause(); 


ZERE, RAKEN AmE EL, TextView Z zii hup 
到 SMS 消 息 时 活动 不 在 前 台 ，TextView 将 不 会 被 更 新 。 
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2. 通过 BroadcastReceiver 调 用 一 个 活动 


有 前面 的 示例 说 明了 如 何 传 递 接收 到 的 SMS 消 奶 来 在 活动 中 显示 。 然 而 ， 在 许多 情况 下 ， 当 
接收 SMS 消 县 时 活动 可 能 在 后 台 。 在 这 种 情况 下 ， 当 接收 一 条 消息 时 ， 如 宁 能 将 活动 推 到 前 侣 
将 是 很 有 用 的 。 下 面 的 “ 试 一 试 ” 展 示 了 该 如 何 做 到 这 一 点 。 


调用 一 个 活动 


(1) 使 用 在 8.1.3 节 所 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 行 : 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


/ / -—— Fi3Kfm SMS RE UEBER --- 
intentFilter = new IntentFilter(); 
intentFilter.addAction("SMS RECEIVED ACTION"); 


//--- 注 册 接 收 者 --- 


registerReceiver(intentReceiver, intentFilter); 


btnSendSMS = (Button) findViewById (R.id.btnSendSMs35); 
btnSendSMS.setOnClickListener (new View.OnClickListener() 


{ 
public void onClick(View v) 
{ 
//sendSMS("5554", "Hello my friends!"); 
Intent i 三 new 
Intent(android.content.Intent.ACTION VIEW); 
i.putExtra("address", "5556; 5558; 5560"); 
l.putExtra("sms body", "Hello my friends!"); 
i.setType ("vnd.android-dir/mms-sms"); 
startActivity(i); 
} 
H); 
} 
QOverride 


protected void onResume() | 
//-=--- 注 册 接 收 者 --- 
//registerReceiver(intentReceiver, intentFilter); 


super.onResume(); 


aGOverride 
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protected void onPause() { 
/ / - — ix 5H REB --- 


//unregisterReceiver (intentReceiver); 


super.onPause(); 


Override 


protected void onDestroy() { 


//--- 注 销 接收 者 --- 


unregisterReceiver(intentReceiver); 


super.onPause(); 


(2) 在 SMSReceiver.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


(Override 


public void onReceive(Context context, 


{ 


Intent intent) 


//--- 获 取 传 入 的 SMSs 消 息 --- 


Bundle bundle 


— intent.getExtras(); 


SmsMessage[] msgs - null; 
String str = vU": 
if (bundle != null) 


Í 


//--- 检 索 接 收 到 的 SMS 消 息 --- 


Object[] pdus - 


msgs = 


for (int i-0; 


(Object[]) bundle.get ("pdus"); 


new SmsMessage[pdus.length]; 


1i«msgs.length; IL++) 1 


msgs[i] = SmsMessage.createFromPdu((byte[])pdus[il); 
str += "SMS from " + msgs[il].getOriginatingAddress(); 
str += " zi"; 

str += msgs[i].getMessageBody().toString(); 

Str = "An"; 


} 


/ / -— SzRSITBJSMSiB AR -——- 
Toast.makeText(context, str, Toast.LENGTH SHORT).show(); 


//---JaxlMainActivity--- 
Intent mainActivitylntent = new Intent (context, MainActivity.class); 
mainActivityIntent.setFlags (Intent.FLAG ACTIVITY NEW TASK); 
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context.startActivity (mainActivityIntent); 


//--- 发 送 一 个 广播 意图 来 更 新 活动 中 接收 到 的 sMs--- 


Intent broadcastIntent = new Intent(); 


broadcastIntent.setAction("SMS8 RECEIVED ACTION"); 


broadcastIntent.putExtra("sms", str); 


context.sendBroadcast (broadcastIntent); 
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(3) 按 如 下 所 示 修 改 main.xml 文 件 : 


«activity android:name-",.MainActivity" 
android:label-"8string/app name" 
android:launchMode-"singleTask" > 

«intent-filter-^ 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
«/activity» 


(4) 按 F114 
zJ AS 38. 

(4) fE HDDMS PX In] EU d XS — ARSMSiIHAA. AAR, EAKR HERR ERA 
收 的 SMS 消 息 。 

示例 说 明 

在 MainActivity 类 中 ， 痛 先 在 活动 的 OnCreate(O) 事 件 而 不 是 onResume(O 事 件 中 注册 
BroadcastReceiver, 并 在 onDestroy0 事 件 而 不 是 onPause() 事 件 中 进行 注销 。 这 确保 了 活动 即使 是 
在 后 人 台 ， 它 仍 能 够 侦 听 广播 意图 。 


接 下 来 ， 修 改 SMSReceiver 类 中 的 onReceive0) 事 件 ， 使 用 一 个 意图 在 广播 男 一 个 意图 之 前 将 
活动 推 到 前 人 台 : 


LE 在 Android 模 拟 器 上 调试 应 用 程序 。 当 MainActivity 显 示 时 ， 单 击 Home 按 钮 将 活 


//---JaAsMainActivity--- 

Intent mainActivitylntent — new Intent(context, MainActivity.class); 
mainActivityIntent.setFlags(Intent.FLAG ACTIVITY NEW TASK); 
context.startActivity (nainActivityIntent); 


//--- 发 送 一 个 广播 意图 来 更 新 活动 中 接收 到 的 SMS---- 

Intent broadcastIntent = new Intent(); 
broadcastIntent.setAction("SMS8 RECEIVED ACTION"); 
broadcastIntent.putExtra("sms", str); 


context.sendBroadcast (broadcastIntent); 


startActivity() 方 法 启动 活动 ， 并 将 它 推 到 前 台 。 注 意 ， 需 要 设置 Intent.FLAG_ACTIVITY_ 
NEW_TASK 标 志 ， 因 为 从 一 个 活动 上 下 文 的 sini 用 startActivity() 需 要 FLAG_ACTIVITY_ 
NEW ME , 
需要 将 AndroidManifest.xml 文 件 中 <activity> 元 素 的 launchMode 属 性 设置 为 singleTask: 


«activity android:name-".MainActivity" 
android:label-"string/app name" 
android:launchMode-"singleTask" > 

如 条 不 进行 设置 ， 在 应 用 程序 收 到 SMS 消 县 时 ， 将 局 动 活动 的 多 个 实例 。 
注意 在 这 个 示例 中 ， 当 活动 在 后 人 台 时 (如 单 击 Home 按 钮 来 显示 主屏 算 )， 随 寿 SMS 消 有 息 的 接 
收 ， 活 动 将 被 推 到 前 人 台 并 且 TextView 得 到 更 新 。 人 但是， 如果 活动 被 终止 (如 单 击 Back 按 钮 来 销 师 


它 )， 活 动 会 再 次 启动 ， 但 TextView 不 会 被 更 新 。 
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8.1.5 说 明和 警告 


虽然 发 送 和 接收 SMS 消 上 息 的 能 力 使 Android 成 为 开发 复杂 应 用 程序 的 一 个 非常 引 人 注 目的 
平台 ,但 这 种 灵活 性 是 要 付出 代价 的 。 貌 似 无 害 的 应 用 程序 可 能 在 禹 后 发 送 SMS 消 奶 而 用 户 
对 此 一 无 所 知 。 正 如 最 近 一 个 基于 SMS 的 Android 木 马 程序 的 例子 (http://forum.vodafone.co.nz/ 
topic/5719-android-sms-trojan-warning/)， 访 应 用 程序 日 称 是 一 个 媒体 播放 器 ， 一 旦 安装 ， 它 将 问 
一 个 收费 郧 贯 的 号 人 码 发 送 SMS 消 上 朋 ， 导 至 用 户 产 生 巨 额 话费 。 

尽管 用 户 需 要 显 式 地 将 权限 授予 应 用 程序 ， 但 也 仅仅 是 在 安装 时 才 显 示 对 权限 的 请 求 。 图 
8-7 展 示 了 在 模拟 需 上 (与 真正 的 设备 上 相同 ) 试 图 安 闭 应 用 程序 (作为 一 个 APK 文 件 ， 第 11 章 将 对 
如 何 打 包 Android 应 用 程序 进行 详细 讨论 ) 时 所 显示 的 权限 请 求 。 如 果 用 户 单 击 Install 按 钮 ， 他 或 
她 将 被 认为 授予 了 权限 ， 允 许 应 用 程序 发 送 和 接收 SMS 消 县。 这 是 很 危险 的 ， 因 为 在 应 用 程序 
安装 后 ， 它 可 以 发 送 和 接收 SMS 消 息 ， 而 不 再 给 用 户 任 何 提示 。 


i$ 5554EmulatorWithsD 


Do you want to install this 
application? 


Allow this application to: 


图 8-7 


此 外 ， 应 用 程序 还 可 以 “ 串 探 ” 传 入 的 SMS 消 息 。 例 如 ， 在 8.1.4 节 所 学 到 的 技术 基础 上 ， 
可 以 很 容易 地 编写 出 检查 SMS 消 息 中 某 些 关键 字 的 应 用 程序 。 当 SMS 消 息 包含 正在 查找 的 关键 
字 时 ， 可 以 使 用 Location Manager( 将 在 第 9 章 中 讨论 ) 来 获取 您 的 地 理 位 置 ， 然 后 给 SMS 消 息 的 发 
送 者 发 回 坐 标 。 这 样 ， 这 个 发 送 者 就 可 以 很 容易 地 追踪 您 的 位 置 。 所 有 这 些 任务 都 可 以 很 容易 
地 在 您 一 无 所 知 的 情况 下 完成 ! 也 就 是 说 ， 用 户 应 该 尽量 避免 安装 来 历 不 明 ( 例 如 来 自 未 知 的 网 
vi MMEA ASA Android YH FEST o 


8.2 发送 电子 邮件 


与 SMS 消 息 传 递 类 似 ，Android 还 文 持 电子 邮件 。Android 上 的 GmailyEmail 用 程序 可 以 使 您 
使 用 POP3 或 IMAP 来 配置 电子 邮件 账户 。 除 了 使 用 GmaiVyEmail 习 用 程序 发 送 和 接收 电子 邮件 外 ， 
还 可 以 通过 编程 方式 从 Android 应 用 程序 中 发 送 电 子 邮 件 。 下 面 的 “ 试 一 试 ” 将 告诉 您 如 何 做 。 


A 
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以 编程 方式 发 送 电子 邮件 
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Emails.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创建 一 个 名 为 Emails 的 新 的 Android 项 目 。 
(2) 在 main.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


«?xml version-"1.0" encoding-"utf-8"?- 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 


«Button 
android:id-"((*id/btnSendEmail" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Send Email" /» 


«/LinearLayout» 


(3) 在 MainActivtiyjava 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Email; 


import android.app.Activity; 


import android.os.Bundle; 


import android.content.Intent; 
import android.net.Uri; 
import android.view.View; 


import android.widget.Button; 


public class MainActivity extends Activity 1 
Button btnSendEmail; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


btnSendEmail = (Button) fidViewById(R.id.btnSendEmail); 
btnSendEmail.setOnClickListener (new View.OnClickListener() 
i 
public void onClick(View v) 
{ 
String[] to = {"weimenglee@learn2develop.net", 


"weimenglee(gmail.com")]; 
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String[] ce = ("course8ülearn2develop.net"); 
sendEmail(to, cc, "Hello", "Hello my friends!"); 


}); 


//--- 发 送 一 条 SMS 消 息 到 另 一 个 设备 --- 


private void sendEmail(String[] emailAddresses, String[] carbonCopies, 


String subject, String message) 
i 


Intent emaillntent = new Intent(Intent.ACTION SEND); 


emaillntent.setData(Uri.parse("mailto:")); 
String[] to = emailAddresses; 

String[] cc - carbonCopies; 
emaillntent.putExtra(Intent.EXTRA EMAIL, to); 
emaillntent.putExtra(Intent.EXTRA CC, ca); 


emaillntent.putExtra(Intent.EXTRA SUBJECT, subject); 


emaillntent.putExtra(Intent.EXTRA TEXT, message); 
emaillntent.setType("message/rfc822"); 


startActivity (Intent.createChooser(emaillntent, "Email")); 


(4) 按 F11 键 在 真正 的 Android 设 备 上 调试 应 用 程序 。 单 击 Send Email 
按钮 可 以 看 到 在 设备 上 启动 了 Email 应 用 程序 ， 如 图 8-8 所 示 。 

示例 说 明 

在 这 个 示例 中 ， 局 动 内 置 的 Email 以 用 程序 来 发 送 一 封 电 子 邮件 消 
县 。 要 做 到 这 一 点 ， 可 以 使 用 一 个 Intent 对 象 并 使 用 setData0)、putExtra0) 
和 setType0 方 法 来 设置 各 种 参数 : 


«QA MA b aa E 1:33AM 
weimengleeti gmail.com 

-Weliengieeuiedr Hzdevelüp. 

| net», «weim englee@ gmail.com», | | 


| «cpurse(ilea rn2develop.net*, 


| Hello | 


Hello my friends! 


D'iscarc 


图 8-8 


Intent emaillntent = new Intent(Intent.ACTION SEND); 


emaillntent.setData(Uri.parse("mailto:")); 
String[] to = emailAddresses; 

String[] cc = carbonCopies; 
emailIntent.putExtra(Intent.EXTRA EMAIL, to); 
emaillntent.putExtra(Intent.EXTRA CC, cc); 


emailIntent.putExtra(Intent.EXTRA SUBJECT, subject); 


emaillIntent.putExtra(Intent.EXTRA TEXT, message); 
emaillntent.setType("message/rfc822"); 


startActivity(Intent.createChooser(emaillIntent, "Email")); 


8.3 联网 


表面 的 章节 讲述 了 如 何 利 用 SMS 和 电子 邮件 与 外 界 进行 连接 。 实 现 这 一 目标 的 另 一 种 方式 
是 使 用 HTTP 协 议 。 使 用 HTTP 协 议 ， 可 以 执行 各 种 任务 ， 如 从 Web 服 务 器 上 下 载 Web 页 面 、 下 


载 二 进 制 数据 等 。 
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下 面 的 “ 试 一 试 ”创建 了 一 个 新 的 Android 项 目 ， 可 以 使 用 HTTP 协 议 连接 到 Web 上 来 下 载 
各 种 数据 。 


创建 项 目 


Networking.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 创 建 一 个 名 为 Networking 的 新 的 Android 项 目 。 
(2) 在 AndroidManifest.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


«?xml version-"1.0" encoding-"utf-8"?- 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Networking" 
android:versionCode-"]" 
android:versionName-"1.0"- 
«application android:icon-"Gdrawable/icon" android:label-"8string/app name"- 
«activity android:name-".MainActivity" 
android:label-"Qstring/app name"- 
«intent-filter-? 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"8" /> 
«uses-permission android:name-'"android.permission.INTERNET'"» «/uses-permission» 
«/manifest» 


(3) 在 MainActivity.java 文 件 中 导入 以 下 命名 空间 : 
package net.learn2develop.Networking; 


import android.app.Activity; 


import android.os.Bundle; 


import java.io.IOException; 

import java.io.InputStream; 

import java.io.InputStreamReader; 
import java.net.HttpURLConnection; 
import java.net.URL; 

import java.net.URLConnection; 

import android.graphics.Bitmap; 
import android.graphics.BitmapFactory; 
import android.widget.ImageView; 
import android.widget.Toast; 


import javax.xml.parsers.DocumentBuilder; 


import javax.xml.parsers.DocumentBuilderFactory; 


import javax.xml.parsers.ParserConfigurationException; 
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org.w3c.dom.Document; 
org.w3c.dom.Element; 
org.w3c.dom.Node; 
org.w3c.dom.NodeList; 


public class MainActivity extends Activity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


aOverride 


public void onCreate(Bundle savedInstanceState) { 


super.onCreate (savedInstanceState); 


setContentView(R.layout.main); 


(4) 在 MainActivity.java 文 件 中 定义 OpenHttpConnection() 方 法 : 


public class MainActivity extends Activity I 


private InputStream OpenHttpConnection(String urlString) 


throws IOException 


{ 


InputStream in - null; 


int response = -1; 


URL url = new URL(urlString); 


URLConnection conn - url.openConnection(); 


if ('(conn instanceof HttpURLConnection)) 
throw new IOException("Not an HTTP connection"); 


tryí 


HttpURLConnection httpConn - (HttpURLConnection) conn; 


httpConn.setAllowUserInteraction(false); 

httpConn.setInstanceFollowRedirects (true); 

httpConn.setRequestMethod ("GET") ; 

httpConn.connect(); 

response = httpConn.getResponseCode(); 

if (response == HttpURLConnection.HTTP OK) { 
in = httpConn.getInputStream(); 


] 
catch (Exception ex) 
{ 
throw new IOException ("Error connecting"); 
} 


return in; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


AOverride 


public void onCreate(Bundle savedInstanceState) { 
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super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


示例 说 明 


由 于 是 使 用 HITP 协 议 连接 到 Web 上 ， 上 所 以 应 用 程序 需要 INTERNET 权 限 。 因 此 ， 首 先 要 做 
的 是 在 AndroidManifest.xml 文 件 中 添加 这 一 权限 。 
然后 定义 OpenHttpConnection0 方 法 ， 它 接受 一 个 URL 字 和 从 串 ， 并 返回 一 个 InputStream 对 象 。 使 
用 InputStream 对 象 ， 可 以 从 流 对 象 中 读 取 字 节 以 下 载 数 据 。 在 此 方法 中 ， 利 用 HttpURLConnection 对 
象 ， 打 开 一 个 到 远程 URL 的 HITP 连 接 。 设 置 连接 的 各 种 属性 ， 如 请 求 方法 等 : 
HttpURLConnection httpConn - (HttpURLConnection) conn; 
httpConn.setAllowUserInteraction(false); 


httpConn.setInstanceFollowRedirects (true); 
httpConn.setRequestMethod ("GET") ; 


在 尝试 建立 与 服务 器 的 连接 后 ， 从 服务 器 获得 HTTP 响 应 码 。 如 果 建立 了 连接 (通过 响应 码 
HTTP OK)， 那 么 就 可 以 继续 从 连接 获取 一 个 InputStream 对 人 象 : 
httpConn.connect (); 
response = httpConn.getResponseCode (); 
if (response == HttpURLConnection.HTTP OK) 1 
in — httpConn.getInputStream(); 


使 用 InputStream 对 象 ， 就 可 以 开始 从 服务 器 上 下 载 数据 了 。 


8.3.1 下 载 二 进 制 数据 


十 要 执行 的 常见 任务 之 一 是 从 Web 上 下 载 二 进 制 数 据 。 例 如 ， 您 可 能 想 从 一 台 服 务 右 上 下 
载 一 幅 图 像 以 在 应 用 程序 中 显示 。 下 面 的 “ 试 一 试 ” 说 明了 这 一 任务 是 如 何 完成 的 。 


创建 项 目 


(1) 打开 先前 创建 的 同一 个 项 目 ， 在 main.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


«?xml version-"1.0" encoding-"utfí-8"?- 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 


«ImageView 
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android:id="@+id/img" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout gravity-"center'" /> 


</LinearLayout> 


(2) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


public class MainActivity extends Activity I 


ImageView img; 


private InputStream OpenHttpConnection(String urlString) 
throws IOException 
1 

YT 


private Bitmap DownloadImage (String URL) 
{ 
Bitmap bitmap - null; 
InputStream in - null; 
try 1{ 
in — OpenHttpConnection (URL); 
bitmap = BitmapFactory.decodeStream(in); 
in.close(); 
} catch (IOException el) ( 
Toast.makeText(this, el.getLocalizedMessage(), 
Toast.LENGTH LONG).show(); 


el.printStackTrace(); 
} 
return bitmap; 


/** 当 活动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//--- 下 载 一 幅 图 像 --- 
Bitmap bitmap = 
DownloadImage ( 
"http: //www.streetcar.org/mim/cable/images/cable-01.Jjpg"); 
img = (ImageView) findViewById (R.id.img); 
img.setlImageBitmap (bitmap); 
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(3) 按 F11 键 在 Android 模 拟 需 上 调试 应 用 程序 。 图 8-9 展 示 了 从 Web 上 下 载 了 一 幅 疼 像 并 在 
ImageView 中 显示 。 


示例 说 明 
DownloadImage() 方 法 接受 要 下 载 的 图 像 的 URL， 然 后 使 用 之 前 定义 过 的 OpenHttp- 
Connection0 方 法 打开 到 服务 器 的 连接 。 利 用 连接 返回 的 InputStream 对 象 ， 使 用 BitmapFactory 类 


的 decodeStream0 〇 方法 来 下 载 和 解 公 数据 ， 使 之 成 为 一 个 Bitmap 对 象 。DownloadImage() 方 法 返回 
—^r Bitmap] $. 


前 S554;Android 2.2 Emulator 


EJ AB 2:51 An 


Networking 


图 8-9 
然后 ， 使 用 一 个 ImageView 视 图 将 该 图 像 显 示 出 来 。 


从 模拟 器 指向 localhost 


使 用 Android 模 拟 器 工作 时 , 可 能 经 常 要 使 用 localhost 来 访问 驻 留 在 本 地 Web 服 务 器 上 的 
数据 , 例如 , 您 自己 的 Web 服 务 很 可 能 在 开发 期 间 驻 留 在 本 地 的 计算 机 上 , 而 且 您 希望 在 用 于 编 
写 Android 应 用 程序 的 同一 台 开 发 机 上 测试 它 。 在 这 种 情况 下 , 应 该 使 用 特殊 的 JP 地址 10.0.2.2 

(而 不 是 127.0.0.]) 来 指向 主机 的 回环 接口 从 Android 模 拟 器 的 角度 来 看 , localhost (127.0.0.1) 
指 的 是 模拟 器 自己 的 回环 接口 。 


8.3.2 下 载 文本 文件 
除了 下 载 二 进 制 数据 ， 还 可 以 下 载 纯 文本 文件 。 例 如 ， 您 可 能 会 写 一 个 RSS Reader 应 用 程 


He. PEE PAERQRSS XMI 源 来 进行 处 理 。 下 面 的 “ 试 一 试 ” 说 明了 如 何在 应 用 程序 中 下 载 纯 
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文本 文件 。 
下 载 纯 文本 文件 


(1) 打开 先前 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


public class MainActivity extends Activity I{ 


ImageView img; 


private InputStream OpenHttpConnection(String urlString) 
throws IOException 
1 

'P IT 


private Bitmap DownloadlImage (String URL) 
{ 
Pss 


private String DownloadText(String URL) 
i 
int BUFFER SIZE = 2000; 
InputStream in - null; 
try 1 
in — OpenHttpConnection (URL); 
} catch (IOException el) ( 
Toast.makeText(this, el.getLocalizedMessage(), 
Toast.LENGTH LONG).show(); 


el.printStackTrace(); 


return "": 


InputStreamReader isr = new InputStreamReader (in); 


int charRead; 


String str = ""; 
char[] inputBuffer = new char[BUFFER SIZE]; 
try { 


while ((charRead - isr.read(inputBuffer))»0) 

t 
//--- 将 字符 转换 成 字符 串 --- 
String readString - 

String.copyValueOf(inputBuffer, 0, charRead); 

str += readString; 
inputBuffer — new char[BUFFER SIZE]; 

} 

in.close(); 

} catch (IOException e) { 

Toast.makeText (this, e.getLocalizedMessage(), 

Toast. LENGTH LONG) . show () ; 
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e.printStackTrace(); 
return ""; 


) 


return str; 


/** 当 活动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//--- 下 载 一 副 图 像 --- 
Bitmap bitmap = 
DownloadImage ( 
"http://www.streetcar.org/mim/cable/images/cable-01.jpg"); 
img = (ImageView) findViewById(R.id.img); 
img.setlImageBitmap (bitmap); 


// --- FRÉ—^RSSiR--- 
String str - DownloadText( 
"http: //www.appleinsider.com/appleinsider.rss"); 
Toast.makeText(getBaseContext(), str, 
Toast.LENGTH SHORT).show(); 


(2) T&F11SEfEAndroide E28. EAMH ET o Éd8-10/ fs Y PIRRSSUSOT- H Toast KHET n 
[ d 5354Android 2.2 Emulator 


aA 3 2:53 An 


BN g eben — dini isider 21 | 
vi Mk= "jam 
ct M inque ne he amen 


i We the lSeding source of Insidern um 4 
"apo irumcrson Rppte com utem: 
gp desciptlon* ^g 
exlanguagesenis«s/language? 
S «[astPulldDatesrri, 10. Dec 2010! = 
20: 20:54:39 -0500/lastBulldDaiez. Feraro preto | 


«title» A ipiernsidere/title- 


pp 
«url»http://Immages. 2 
appleinsider.com toolbar- logo Lext glf«/ 
url= 
nba 一 一 一 一 一 一 一 
com/«/link» 
Cr aana aaa 


示例 说 明 
DownloadText(O 方 法 接受 要 下 载 的 文本 文件 的 URL， 然 后 返回 下 载 的 文本 文件 的 字符 串 。 


266 


第 8 章 ”消息 传递 和 联网 


基本 上 是 打开 一 个 到 服务 器 的 HTTP 连 接 ， 然 后 使 用 一 个 InputStreamReader 对 象 从 流 中 读 取 每 个 
字符 ， 将 它们 保存 在 一 个 String 对 象 中 。 


8.3.3 ”访问 Web 服 务 


到 目前 为 止 ， 您 已 经 了 解 了 如 何 从 Web 上 下 载 图 像 和 文本 。8.3.2 节 展示 了 如 何 从 服务 器 下 
载 一 个 RSS 源 。 很 多 时 候 ， 您 需要 下 载 XML 文 件 并 解析 其 内 容 ( 使 用 Web 服 务 束 是 这 样 一 个 很 好 
的 示例 )。 因 此 ， 在 本 节 中 将 学 习 如 何 使 用 HTTP 的 GET 方 法 连接 到 一 个 Web 服 务 。 一 旦 Web 服 务 
返回 一 个 XML 格式 的 结果 ， 就 可 提取 相关 部 分 ， 并 使 用 Toast 类 显示 其 内 容 。 
在 这 个 示例 中 ， 将 要 使 用 的 Web 方 法 来 日 http://services.aonaware.com/DictService/DictService. 
asmx?op=Define。 此 Web 方 法 是 从 Dictionary 这 个 Web 服 务 返 加 一 个 给 定单 词 的 定义 。 
Web 方 法 按 以 下 格式 接受 一 个 请 求 : 


GET /DictService/DictService.asmx/Define?Wword-string HTTP/1.1 
Host: services.aonaware.com 

HTTP/1.1 200 OK 

Content-Type: text/xml; charset-utf-8 

Content-Length: length 


它 按 如 下 格式 返回 啊 应 : 


«?xml version-"1.0" encoding-"utf-8"?- 
«WordDefinition xmlns-"http://services.aonaware.com/webservices/"» 
«Word»stringc/Word» 
«Definitions»? 
«Definition» 
«Word»string«c/Word» 
«Dictionary» 
«Id»string«c/Id» 
«Name»stringc/Name- 
«/Dictionary» 
«WordDefinition»stringc/WordDefinition-» 
«/Definition» 
«Definition» 
«Word»string«c/Word» 
«Dictionary» 
«Id»string«c/Id» 
«Name»stringc/Name» 
«/Dictionary» 
«WordDefinition»string«/WordDefinition» 
«/Definition» 
«/Definitions» 
«/WordDefinition» 


因此 ， 要 获得 一 个 单词 的 定义 ， 需 要 建立 一 个 到 Web 方 法 的 HITP 连 接 ， 然 后 解析 返回 的 
XML 结果 。 下 面 的 “ 试 一 试 ” 将 告诉 您 该 如 何 做 。 
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使 用 Web 服 务 


(1) 使 用 先 衣 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 漆 加 下 列 粗 体 显示 的 语句: 


public class MainActivity extends Activity { 
ImageView img; 


private InputStream OpenHttpConnection(String urlString) 
throws IOException 
i 

f P 


private Bitmap DownloadImage (String URL) 
i 
P ETT 


private String DownloadText (String URL) 
{ 


private void WordDefinition(String word) { 

InputStream in - null; 

try ( 
in — OpenHttpConnection( 

"http: //services.aonaware.com/DictService/DictService.asmx/Define?word-" + word); 
Document doc - null; 
DocumentBuilderFactory dbf - 
DocumentBuilderFactory.newInstance(); 

DocumentBuilder db; 


try I 
db = dbf.newDocumentBuilder (); 
doc = db.parse(in); 


) catch (ParserConfigurationException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 

) catch (Exception e) { 

// TODO Auto-generated catch block 
e.printStackTrace(); 


} 


doc.getDocumentElement ().normalize(); 


//--- 检 索 所 有 的 <Definition> 节 点 --- 
NodeList itemNodes = 
doc.getElementsByTagName ("Definition"); 


String strDefiition = ""; 
for (int i = 0; i < definitionElements.getLength(); i++) í( 
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Node itemNode = defiitionElements.item(í(1i); 
if (itemNode.getNodeType() == Node.ELEMENT NODE) 
{ 

/ / - EFT ra SR US --- 


Element definitionElement = (Element) itemNode; 


//--- 获 取 在 <Definition> 元 素 下 的 所 有 <WordDefinition> 元 素 --- 

NodeList wordDefinitionElements = 
(definitionElement).getElementsByTagName ( 
"WordDefinition"); 


strDefiition - ""; 
for (int j = 0; j < wordDefinitionElements.getLength(); 
j++) 1 
//--- 将 <WordDefinition> 节 点 转换 为 元 素 --- 
Element wordDefinitionElement = 
(Element) wordDefinitionElements.item(Jj); 


//--- 获 取 在 <WordDefinition> 元 素 下 的 所 有 子 节 点 --- 
NodeList textNodes = 
((Node) wordDefmitionElement) .getChildNodes () ; 


strDefinition += 
((Node) textNodes.item(0)).getNodeValue() + ". "; 


//--- 显 示 标题 --- 
Toast.makeText(getBaseContext(),strDefinition, 
Toast.LENGTH SHORT).show(); 


} 
} catch (IOException el) { 
Toast .makeText (this, el.getLocalizedMessage(), 
Toast.LENGTH LONG).show(); 
el.printStackTrace(); 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


setContentView(R.layout.main); 


//--- 下 载 一 幅 图 像 --- 
Bitmap bitmap = 
DownloadImage( 


"http://www.streetcar.org/mim/cable/images/cable-01.jpg"); 
img = (ImageView) findViewById(R.id.img); 
img.setImageBitmap (bitmap); 
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J 
String str = DownloadText( 
"http://www.appleinsider.com/appleinsider.rss"); 
Toast.makeText(getBaseContext(), str, 
Toast.LENGTH SHORT).show(); 


//--- 使 用 GET 访 问 Web 服 务 --- 
WordDefinition ("Apple"); 


(2) 按 Fl1 键 在 Android 模 拟 器 上 调试 应 用 程序 。 图 8-11 展 示 了 解析 Web 服 务 调用 的 结果 并 用 
Toast 类 进行 显示 。 


"WU 5534Andraid 2:2 Emulator 


M B 2:56 om 


Apple XAp"ple* (Ja^]p"p']), n. [DE. appel, 
eppel, AS. [ae]ppel, 
[ae]pl; akin Lo Fries. & D. appel, OHG, 
aphul, aphol; G: 
apfel, Icel. epli, Sw. ["a]ple, Dan. 
lae]ble, Gael. ubhall, 
W. afal, Arm. aval, Lith. ob[*u]lys, Russ. 
labloko; of 
unknown orlgln.] 
1. The fleshy pome or fruit of a 
rosaceous tree (4Pyrus 
malust) cultivated in numberless 
varlelies in the 
temperate zones. 
[1913 Webster] 


Note: The European crab apple Is 
supposed to be the original 
kind. from which all others have 


E 


prung. 
[1913 Webster] 


2. (bot.) Any tree genus {Pyrus} which 
has the stalk sunken 
Into the base of the fruit; an apple 
tree. 


示例 说 明 
WordDefinition() 方 法 首先 打开 一 个 到 Web 服 务 的 HTTP 连 接 ， 传 入 一 个 您 感 兴 趣 的 单词 : 


in = OpenHttpConnection( 


"http: //services.aonaware.com/DictService/DictService.asmx/Define?word-" + word); 


然后 ， 它 使 用 DocumentBuilderFactory 和 DocumentBuilder 对 象 从 XML 文件 (这 一 文件 是 由 
Web 服 务 返回 的 XML 结果) 中 获得 一 个 Document 对 象 (DOMD): 


Document doc = null; 
DocumentBuilderFactory dbf - 
DocumentBuilderFactory.newInstance(); 
DocumentBuilder db; 
try i 
db = dbf.newDocumentBuilder(); 
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doc = db.parse (in); 

} catch (ParserConfigurationException e) | 
// TODO Auto-generated catch block 
e.printStackTrace (); 

} catch (Exception e) { 

// TODO Auto-generated catch block 
e.printStackTrace (); 


} 


doc.getDocumentElement () .normalize(); 


一 旦 获得 Document 对 钞 ， 您 会 发 现 所 有 具有 <Definition> 标 记 的 元 素 : 
//--- 检 索 所 有 的 <Definition> 节 点 --- 


NodeList itemNodes = 
doc.getElementsByTagName ("Definition"); 


图 8-12 展 示 了 由 Web 服 务 返 回 的 XML 文档 的 结构 。 


"«WordDefinition xmlns:xsis"http://www.w3.o0rg/2001/ 
XMLSchema-instance" xmlns:xsds-"http://www.w3.0rg/2001/ 
XMLSchema" xmlnss"http://services.aonaware.com/ 
webservices/"» 

4«Word*apple«/Word? 
v«Definitions? 
v «Definition? 

«Word»apple«s/Word? 
»«Dictionary»..«/Dictionary? 
»«WordDefinition»..«/WordDefinition? 
£/Definition? 

v «Definition» 

«Word»apple«/Word» 

»«Dictionary»..«/Dictionary» 
» «WordDefinition»..«/WordDefinition» 
€«/Definition» 
»«Definition»..«/Definition» 
> «Definition»..«/Definition» 
> «Definition»..«/Definition» 
&«/Definitions» 
«/WordDefinition» 


图 8-12 
由 于 单词 的 定义 包含 在 <WordDefinition> 元 素 中 ， 因 此 继续 对 所 有 的 定义 进行 提取 : 


T TF a 
F 


String strDefinition = 
for (int i = 0; i < definitionElements.getLength(í(); i++) { 


Node itemNode = definitionEbElements.item(í(i); 
if (itemNode.getNodeType() == Node.ELEMENT NODE) 
{ 


//--- 将 节点 转换 为 元 素 --- 


Element definitionElement - (Element) itemNode; 


// -—BMkHBE«Definition»2tX* FAS «WordDefinition»752E--- 
NodeList wordDefinitionElements = 
(definitionElement).getElementsByTagName ( 


"WordDefinition"); 


strDefinition = "'"; 
for (int j = 0; j < wordDefinitionElements.getLength(); 
j++) d 


//--- 将 <WordDefinition> 节 点 转换 为 元 素 --- 


2/1 


2 
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Element wordDefinitionElement = 


(Element) wordDefinitionElements.item(j); 


/ | -—dkBtE«WordDefinition»7rLX« MAMAT D m--- 
NodeList textNodes = 
((Node) wordDefinitionElement) .dgetChildNodes () ; 
//--- 获 取 第 一 个 包含 文本 的 节点 --- 
strDefinition += 
((Node) textNodes.item(0)).getNodeValue() + ". "; 
] 
//--- 显 示 标 题 --- 
Toast.makeText(getBaseContext (),strDefinition, 
Toast.LENGTH SHORT).show(); 


} 
} catch (IOException el) { 
Toast .makeText (this, el.getLocalizedMessage(), 
Toast.LENGTH LONG).show(); 
el.printStackTrace(); 


上 述 代码 循环 遍历 所 有 <Definition> 元 素 ， 然 后 为 每 一 个 <Definition> 元 素 寻 找 名 为 
<WordDefinition> 的 子 元 素 。 单 词 的 定义 包含 在 <WordDefinition> 元 素 的 文本 内 容 中 。Toast 类 显 
示 检 索 到 的 每 一 个 单词 的 定义 。 


8.3.4 执行 异步 调用 


到 目前 为 止 ， 在 前 面 几 节 中 建立 的 所 有 连接 都 是 同步 的 一 一 即 与 服务 器 的 连接 直到 接收 了 
数据 后 才 返 回 。 在 现实 生活 中 ， 由 于 网 络 连接 固有 的 缓慢 的 特征 ， 这 样 做 存在 一 些 问 题 。 当 连 
接 到 一 个 服务 器 来 下 载 一 些 数据 时 ， 应 用 程序 的 用 户 界面 在 没有 获得 响应 之 前 将 保持 “冻结 ” 
的 状态 。 在 大 多 数 情况 下 ， 这 是 不 能 被 接受 的 。 因 此 ， 需 要 确保 与 服务 器 的 连接 是 按 异 步 的 方 
式 进行 。 

异步 连接 到 服务 器 的 最 容易 的 方式 是 使 用 Android SDK 提 供 的 AsyncTask 类 。 使 用 
AsyncTask， 可 以 使 您 在 一 个 单独 的 线程 中 执行 后 台 任 务 ， 并 在 一 个 UI 线程 中 返回 结果 。 使 用 这 
个 类 可 以 使 您 执行 后 人 操作， 而 无 须 处 理 复兴 的 线程 问题 。 

使 用 先前 从 服务 器 上 下 载 一 幅 图 像 ， 然 后 显示 在 ImageView 中 的 示例 ， 可 以 在 AsyncTask 类 
的 一 个 实例 中 包含 如 下 所 示 代 位 : 


public class MainActivity extends Activity 1 


ImageView img; 


private class BackgroundTask extends AsyncTask 
«String, Void, Bitmap» { 
protected Bitmap dolnBackground(String... url) { 
//--- 下 载 一 幅 图 像 --- 
Bitmap bitmap = DownloadImage (ur1[0]); 
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return bitmap; 
} 


protected void onPostExecute(Bitmap bitmap) { 
ImageView img = (ImageView) findViewById (R.id.img); 
img.setlImageBitmap (bitmap); 


} 


private InputStream OpenHttpConnection (String urlString) 
throws IOException 


{ 


] 


AXR EMEEN T —7 ^4 H&AsyncTask2SHJ2s. x$, fEBackgroundTask2S P 3.4 V4] 77 
法 doInBackground0 和 onPostExecute0。 将 所 有 需要 异步 运行 的 代 但 放 在 doImnBackgroundO 方 
法 中 。 当 任务 完成 后 ， 其 结果 通过 onPostExecute() 方 法 传 回 。 onPostExecute0) 方 法 是 在 UI 线 程 上 
执行 的 ， 因 此 使 用 从 服务 器 上 下 载 的 位 图 来 更 新 ImageView 是 线程 安全 的 。 


注意 : 在 第 10 章 中 将 学 习 更 多 关于 AsyncTask 类 的 内 容 ， 这 一 章 涵盖 了 如 


7^ 何在 Android 中 开发 服务 。 


要 执行 异步 任务 ， 只 需要 创建 BackgroundIask 关 的 一 个 实例 ， 并 调用 它 的 execute() 方 法 : 


aOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
new BackgroundTask().execute( 


"http://www.streetcar.org/mim/cable/images/cable-01.Jjpg"); 


8.4 本章 小 结 

本 章 讲述 了 与 外 界 通 信和 的 各 种 方式 。 首 先 学 习 了 如 何 发 送 和 接收 SMS 消 息 ， 然 后 学 习 了 如 
何 从 Android 应 用 程序 中 发 送 电 子 邮 件 。 除 了 SMS 消 息 和 电子 邮件 ， 与 外 界 通信 的 另 一 种 方式 是 
通过 使 用 HTTP 协 议 。 使 用 HTTP 协 议 ， 可 以 从 一 台 Web 服 务 器 上 下 载 数据 。 这 方面 一 个 很 好 的 
应 用 是 与 Web 服 务 进行 交互 ， 这 需要 解析 XML 文 件 。 


1. 说 出 在 Android 应 用 程序 中 可 以 用 来 发 送 SMS 消 息 的 两 种 方式 。 
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2. ”说 出 为 发 送 和 接收 SMS 消 息 需要 在 AndroidManifest.xml 文 件 中 声明 的 权限 。 
3. 如 何 通过 BroadcastReceiver 通 知 一 个 活动 ? 
4. ”说 出 为 实现 HTTP 连 接 需 要 在 AndroidManifest.xml 文 件 中 声明 的 权限 。 


本 章 主要 内 容 


t oom 关键 概念 

以 编程 方式 发 送 SMS 消 恩 使 用 SmsManager 类 

发 送 消息 后 获取 反馈 在 sendTextMessage() 方 法 中 使 用 两 个 PendingIntent 对 象 

使 用 意图 发 送 SMS 消 息 ”将 意图 类 型 设置 为 vnd.android-dirmms-sms 

接收 SMS 消 息 实现 一 个 BroadcastReceiver 并 在 AndroidManifest.xml 文 件 中 设置 它 
使 用 意图 发 送 电子 邮件 。 将 意图 类 型 设置 为 message/rfc822 


建 YHTTP 连 搁 使 用 HttpURLConnection 类 
dh | 使 用 Document、DocumentBuilderFactory 和 DocumentBuilder 类 来 解析 由 Web 服 
访问 Web 服 务 ol > 

务 返 回 的 XML 结果 


E 


4i Da 
基于 位 置 的 服务 


本 章 将 介绍 以 下 内 容 
如 何在 Android 应 用 程序 中 显示 Google Maps 
如 何在 地 图 上 显示 缩放 控件 
如 何在 不 同 的 地 图 视图 间 切 换 
如 何在 地 图 上 添加 标记 
如 何 获 取 在 地 图 上 触摸 的 位 置 的 地 址 
如 何 进行 地 理 编码 和 反 向 地 理 编码 
如 何 使 用 GPS、Cell-ID 和 Wi-Fi 三 角 测 量 法 来 获取 地 理 数据 
如 何 监控 一 个 位 置 

近 些 年 来 ， 我 们 都 看 到 了 移动 应 用 程序 的 爆炸 性 增长 。 其 中 一 关 非 党 流行 的 应 用 程序 是 基 
于 位 置 的 服务 ， 即 LBS。LBS 应 用 程序 跟踪 您 的 位 置 ， 并 可 提供 额外 服务 ， 如 定位 附近 的 便利 设 
施 以 及 提供 路 线 规划 建议 等 。 当 然 ，LBS 应 用 程序 中 的 一 个 关键 因素 是 地 图 ， 它 可 以 对 您 的 位 
置 进行 可 视 化 表示 。 

本 章 中 将 学 习 如 何在 Android 旋 用 程序 中 使 用 Google Maps， 以 及 如 何以 编程 方式 操作 它 。 
此 外 ， 还 将 学 习 如 何 利用 Android SDK 中 提供 的 LocationManager 类 获得 您 的 地 理 位 置 。 
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Google Maps 是 与 Android 平 台 捆 绑 在 一 起 的 众多 应 用 程序 之 一 。 除 了 直接 使 用 Maps 旋 用 程 
序 外 ， 还 可 以 将 它 通 入 到 您 目 己 的 应 用 程序 中 来 做 一 些 非 常 酷 的 事情 。 本 节 介 绍 如 何在 Android 
应 用 程序 中 使 用 Google Maps 以 及 用 编程 方式 完成 以 下 功能 : 

e 改变 Google Maps 的 视图 。 

€ 在 Google Maps 中 获取 位 置 的 经 度 和 纬度 。 

e 进行 地 理 编 始 和 反 同 地 理 编 码 (将 一 个 地 址 转换 为 经 纬度 或 有 反之 )。 

@ 在 Google Maps 上 添加 标记 。 


9.1.1 创建 项 目 
开始 时 ， 需 要 首先 创建 一 个 Android 项 目 以 便 在 活动 中 显示 Google Maps. 
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创建 项 目 


2/6 


LBS.zip 代 码 文 件 可 以 在 Wrox.com 上 下 载 


(1) 打开 Eclipse， 按 图 9-1 所 示 创 建 一 个 Android 项 目 。 


注意 : 为 了 在 Android 应 用 程序 中 使 用 Google Maps， 需 要 确保 选择 Google 
APIs 作 为 构建 目标 。Google Maps 并 不 是 标准 Android SDK 的 一 部 分 ， 因 此 需要 
在 Google APIs 附 加 组 件 中 找到 它 。 


(2) 创建 项 目 后 ， 可 以 看 到 在 Google APIs 文 件 夹 下 多 出 来 一 个 JAR 文 件 (maps.jar)， 如 图 9-2 


所 不。 


uS New Android Project 


Mew Android Project 


Creates a new Android Project resource. 


Project name: LBS 
Contents 

@ Create new project in workspace 
(^) Create project from existing source 
Use default location 


Location: | C/Users/Wei-Meng Lee/Beginning Android/LBS 


(^O Create project from existing sample 


Samples: | ApiDemos 


Build Target 

Target Name Vendor Platform 
[^] Android 21-updatel Android Open Source Project 21l-upda.. 
[^] Google APIs Google Inc. 2 1-upda... 
[7] Android 2.2 Android Open Source Project 22 

[^] Google APIs Google Inc. 22 

[^] GALAXY Tab Addon Samsung Electronics Co., Ltd. 22 
Android 2.3 Android Open Source Project 2i 

[^] Google APIs Google Inc. 23 


Properties 
Application name; LBS " 3S LBS 
EE net leam2develop LES b $9 src 
IEEE MMamActiity b cm gen [Generated Java Files] 
— "n 4 E) Google APIs [Android 2.1-updatel] 
b gs android.jar - D:\Android 2.2\android-sdk- 
» (ej mapsjar - DAndroid 2.2\android-sdk-wi 
az assets 
b i» res 
d| AndroidManifest.xml 
default.properties 


Min SDK Version: 9 


示例 说 明 
这 个 简单 的 动作 创建 了 一 个 使 用 Google APIs 附 加 组 件 的 Android 项 目 。Google APIs 附 加 组 


件 包括 了 标准 的 Android 库 ， 以 及 打包 在 maps.jar 文 件 中 的 Maps 库 。 
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9.1.2 ”获取 Maps API 密 钥 


从 Android SDK 发 行 版 1.0 开 始 ， 在 Android 应 用 程序 中 集成 Google Maps 需 要 申请 一 个 倪 费 
的 Google Maps API 密 钥 。 当 申请 这 个 密 钥 时 ， 必 须 同意 Google 的 使 用 条 球 ， 所 以 一 定 要 仔细 
要 申请 一 个 密 钥 ， 可 按照 下 和 面 列 出 的 一 系列 步 又 进行 。 


注意 : Google 提 供 的 关于 申请 Maps API 密 钥 的 详细 文档 参见 http:Wcode. 


google.com/android/add-ons/google-apis/mapkey.html, 


首先 ， 如 果 您 正在 直接 连接 到 您 的 开发 机 的 Android 模 拟 器 或 Android 设 备 上 进行 应 用 程序 测 
试 ， 则 需要 在 默认 文件 夹 (对 于 Windows 7 的 用 户 来 说 是 C:\Usen\<username>\.android) 下 找到 SDK 
调试 证 书 。 您 可 以 进入 Eclipse 并 选择 Window | Preferences 来 验证 调试 证 书 是 否 存 在 。 展 开 
Android 项 ， 并 选择 Build( 如 图 9-3 所 示 )。 在 窗口 的 右 侧 ， 可 以 看 到 调试 证 书 所 在 的 位 置 。 


注意 : 对 于 Windows XP 用 户 来 说 ， 黑 认 的 Android 文 件 夹 是 C:\Documents 


^ and Settings\<username>\Local SettingsVApplication DataVAndroid 。 


type filter text || Build 
— Build Settings: 
4 Android i ] 
Bui ld | [V] Automatically refresh Resources and Assets folder on build 
DDMS [4] Force error when external jars contain native libraries 
Launch Build output 
LogCat © Silent 
Usage Stats C Normal 
dion © Verbose 
» Data Management 


> Help Default debug keystore — CAUsersWei-Meng Lee\.android\debug.keystore 


» Install/Update 

» Java 

» Java EE 

» Java Persistence 
» JavaScript 

» Plug-in Development 
» Remote Systems 
» Run/Debug 

» Server 

» Tasks 

» Team 


Custom debug keystore: 


Terminal 


Validation - Deisits Apply 
@ 


图 9-3 
调试 密 钥 库 的 文件 名 为 debug.keystore。 这 是 Eclipse 用 来 为 应 用 程序 进行 签名 的 证 书 ， 以 便 
应 用 程序 可 以 在 Android 模 拟 器 或 设备 上 运行 。 
使 用 调试 密 钥 库 ， 需 要 使 用 安装 JDK 时 包含 的 Kkeytool.exe 丹 用 程序 来 提取 其 MD5 指 纹 。 这 
个 指纹 是 用 来 申请 免费 Google Maps 密 钥 的 。 通 党 可 以 在 C:\Program Files\Java\<JDK version - 
number>\bin 文 件 夹 下 找 开 keytool.exe。 
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发 出 以 下 命令 (如 图 9-4 所 示 ) 来 提取 MD5 指 纹 : 


keytool.exe -list -alias androiddebugkey -keystore 
"C:rNUsersNM«username»NM.androidNMdebug.keystore" -storepass android 


-keypass android 


= aA snr. wamni 


EN C^Windowsksystem32Xcmd.exe 


C:\Program FilesMJavaNjre6*Sbin^kevtool.exe -list -alias androiddebuakevy -kevstorf 
e "C: Wsers\Hei-Meng LeexX.androidNdebug.keystore -storepass android -keypass an 
dr oid 

androiddebugkev, Rug 3, 2010, PrivateKeyEntry, 

Certificate fingerprint (MD5): EF: 78:61:EB:RBF : E0:B4á :2D:FD:43:5E:1D:26:04 : 34 : BR 


C:\Program FilesMJavasjre6*Sbin?. 


图 9-4 
在 这 个 例子 中 ， 我 的 MD5 指 纹 是 EF:7A:61:EA:AF:E0:B4:2D:FD:43:5E:1D:26:04:34:BA。 
复制 MD5S 证 书 指纹 并 将 Web 浏 览 句 转 到 http:/code.google.comyandroid/maps-api-signup.html。 
按照 页 面 上 的 指令 完成 申请 并 获取 Google Maps 密 钥 。 当 这 一 切 完成 后 ， 就 应 该 可 以 看 到 如 网 9-5 
所 示 的 类 似 信 息 。 


Google Google Maps API 


Maps Google Code Home > Google Maps API > Goagle Maps API Signup 


Thank you for signing up for an Android Maps API key! 


Your key is: 

This key is good for all apps signed with your certificate whose fingerprint is: 
EF:7A:61:EA:AF:E0:B4:2D: FD: 43:5E:1D:26:04:534: BA 

Here is an example xml layout to get you started on your way to mapping glory: 


«com.google.android.maps.MapView 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:apiKey-"OK2eMNyjc5HFPsiobLhe6uLHb8F9ZFmh4uIm7VTA" 
/> 


Check out the API documentation for more information. 


2 注意 : 虽然 可 以 使 用 调试 密 钥 库 的 MD5 指 级 来 获取 用 于 在 Android 模 拟 器 
了 或 设备 上 调试 应 用 程序 的 Maps API 密 钥 ， 但 如 果 试图 将 Android 应 用 程序 作为 
一 个 APK 文 件 部 署 时 ， 密 钥 将 不 再 有 效 。 一 旦 准备 将 应 用 程序 部 署 到 Android 
Market( 或 者 使 用 其 他 发 布 方法 )， 就 需要 使 用 可 以 为 您 的 应 用 程序 进行 签名 的 
证 书 来 重新 申请 一 个 Maps API 密 钥 。 第 11 章 将 对 此 进行 详细 讨论 。 
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9.1.3 显示 地 图 


现在 就 要 准备 在 Android 应 用 程序 中 显示 Google Maps 了 。 这 将 包含 两 个 主要 任务 : 
e 修改 AndroidManifestxml 文 件 ， 添 加 <uses-library> 元 素 和 INTERNET 权 限 。 

e 在 您 的 用 户 界 面 中 添加 MapView 元 素 。 

下 面 的 “ 试 一 试 ” 将 告诉 您 应 该 如 何 做 。 


显示 Google Maps 


(D 使 用 在 前 一 节 中 所 创建 的 项 目 ， 在 main.xml 文 件 中 添加 粗 体 显示 的 行 (一 定 要 用 您 先前 获 
取 的 API 密 钥 奉 换 spiKey 属 性 的 值 ): 


<2xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
«com.google.android.maps.MapView 
android:id-"(*id/mapView" 
android:layout width-"ftill parent" 
android:layout height-"fill parent" 
android:enabled-"true" 
android:clickable-"true" 
android:apiKey-"«YOUR KEY»" /> 
«/LinearLayout» 


(2) fEmain.xml X fF rs JE P AERIS HAT : 


<?xml version-"1.0" encoding-"utf-8"?- 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.LBS" 
android:versionCode-"]" 
android:versionName-"1.0"- 


«application android:icon-"G(drawable/icon" android:label-"8string/app name"> 
«uses-library android:name-"com.google.android.maps" /» 


«activity android:name-".MainActivity" 
android:label-"G8string/app name"- 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 


«/activity» 


«/application» 


«uses-sdk android:minSdkVersion-"8" /» 
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«uses-permission android:name-'android.permission.INTERNET"» </uses-permission> 
«/manifest» 


(3) 在 MainActivity.java 文 件 中 添加 以 下 语句 。 注 意 ，MainActivity 现 在 扩展 MapActivity 类 。 


package net.learn2develop.LBS; 


import android.app.Activity; 


import android.os.Bundle; 
import com.google.android.maps.MapActivity; 


public class MainActivity extends MapActivity I 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


QGOverride 
protected boolean isRouteDisplayed() { 
// TODO Auto-generated method stub 


return false; 


(4) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 图 9-6 展 示 了 在 应 用 程序 的 活动 中 显示 的 
Google Maps. 


i 5555pegleAPIs 2.2 Emulator 
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示例 说 明 

为 了 在 应 用 程序 中 显示 Google Maps， 首 先 需 要 在 清单 文件 中 有 INTERNET 权 限 。 然 后 在 UI 
文件 中 添加 <com.google.android.maps.MapView> 元 素来 把 地 图 先 入 到 活动 中 。 特 别 重要 的 是 ， 
活动 现在 必须 计算 MapActivity 类 ， 而 其 本 身 是 Activity 类 的 扩展 。 对 于 MapActivity 类 ， 需 要 实现 
一 个 方法 : isRouteDisplayed0。 这 一 方法 用 于 Google 的 计算 目的 ， 如 果 在 地 图 上 显示 了 路 径 信 
县 ， 则 此 方法 应 返回 true。 对 于 一 些 最 向 单 的 情况 ， 可 以 只 是 返回 false。 


如 果 看 不 到 地 图 


如 果 您 看 到 的 只 是 一 个 市 有 网 格 的 空白 屏幕 而 没有 显示 Google Maps, 那 最 有 可 能 的 是 
在 main.xml 文 件 中 使 用 了 错误 的 API 密 钥 。 还 有 可 能 是 在 AndroidManifest.xml 文 件 中 缺少 
INTERNET 权 限 。 最 后 , 确保 在 您 的 模拟 器 /设备 上 具有 Internet 访 问 权 限 。 

如 果 程 序 没有 运行 (也 即 程 序 般 涡 ), 那 可 能 是 您 忘记 在 AndroidManifest.xml 文 件 中 添 
加 以 下 语句 : 

«uses-library android:name-"com.google.android.maps" /> 

注意 这 条 语句 在 AndroidManifest.xml 文 件 中 的 位 置 ; "C iE 4 T «Application» 

元 素 内 。 


9.1.4 ”显示 缩放 控件 


9.1.3 世 展示 了 如 何在 Android 应 用 程序 中 显示 Google Maps。 可 以 将 地 图 平移 到 任何 想 要 的 
位 置 上 ， 地 图 能 够 随即 进行 动态 更 新 。 然 而 ， 在 模拟 器 上 是 没有 办 法 对 地 图 上 一 个 特定 的 位 
置 直接 进行 放大 或 缩小 的 (在 一 个 真正 的 Android 设 备 上 ， 可 以 用 手指 捏 放 地 图 进行 缩放 )。 因 
此 ， 在 本 节 中 将 学 习 如 何 利 用 内 置 的 缩放 控件 ， 使 用 户 可 以 对 地 图 进行 放大 或 缩小 的 操作 。 


显示 内 置 的 缩放 控件 
(1) 打开 在 前 面 的 活动 中 创建 的 项 目 ， 添 加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.LBS; 


import android.app.Activity; 


import android.os.Bundle; 

import com.google.android.maps.MapActivity; 

import com.google.android.maps.MapView; 

public class MainActivity extends MapActivity I 
MapView mapView; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


QOverride 


281 


Android 编 程 入 门 经 典 


public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


mapView = (MapView) findViewById(R.id.mapView); 


mapView.setBuiltlinZoomControls (true); 


QOverride 
protected boolean isRouteDisplayed() { 
// TODO Auto-generated method stub 


return false; 


(2) 按 Fl1 键 在 Android 模 拟 器 上 调试 应 用 程序 。 当 单 


Venezuela 


Itte ADI, np ELTE dE H5 AS JS AB Se zs H3 PI EL AR Dno 
放 控 件 ( 如 图 9-7 所 示 )。 可 以 通过 单 击 加 (+)、 减 (-) 图 标 来 ee ee 


Eclivià 


放大 和 缩小 地 图 。 ca | 9 


示例 说 明 


要 显示 内 置 的 缩放 控件 ， 首 先 要 获取 对 地 图 的 引用 图 9-7 
并 调用 setBuiltmZoomControls0O 方 法 : 


mapView = (MapView) findViewById(R.id.mapView); 


mapView.setBuiltlInZoomControls (true); 


除了 显示 缩放 控件 ， 还 可 以 使 用 MapController 类 的 zoomIn0 或 zoomOnutO 方 法 以 编程 方式 来 
实现 对 地 图 的 缩放 。 下 面 的 “ 试 一 试 ” 将 告诉 您 如 何 做 到 这 一 点 。 


以 编程 方式 缩放 地 图 


(1) 使 用 在 前 面 的 活动 中 创建 的 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语 何 : 
package net.learn2develop.LBS; 


import android.app.Activity; 


import android.os.Bundle; 


import com.google.android.maps.MapActivity; 


import com.google.android.maps.MapView; 


import android.view.KeyEvent; 
import com.google.android.maps.MapController; 


public class MainActivity extends MapActivity 1 
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MapView mapView; 

/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate (Bundle savedInstanceState) 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


mapView = (MapView) findViewById(R.id.mapView); 


mapView.setBuiltlInZoomControls (true); 


public boolean onKeyDown(int keyCode, KeyEvent event) 


{ 
MapController mc = mapView.getController(); 
switch (keyCode) 
{ 
case KeyEvent.KEYCODE 3: 
mc.zoomIn(); 
break; 
case KeyEvent.KEYCODE 1: 
mc.zoomOut(); 
break; 
} 
return super.onKeyDown(keyCode, event); 
] 
QGOverride 


protected boolean isRouteDisplayed() I 
// TODO Auto-generated method stub 


return false; 


基于 位 置 的 服务 


} 
} 
(2) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 现 在 ， 可 以 通过 按 下 模拟 器 上 的 数字 键 3 来 
放大 地 图 ， 按 数字 键 1 来 缩小 地 图 。 
示例 说 明 


为 了 处 理 在 活动 上 的 按键 操作 ， 需 要 处 理 onKeyDown 事 件 : 


public boolean onKeyDown(int keyCode, KeyEvent event) 


{ 
Pe 


为 了 管理 对 地 疼 的 平移 和 缩放 ， 需 要 从 MapView 对 象 中 获得 一 个 MapController 关 的 实例 。 
MapController 类 包含 了 zoomIn0 和 zoomoOut0) 方 法 (再 加 上 其 他 一 些 用 来 控制 地 图 的 方法 )， 可 以 


使 用 户 对 地 图 进行 放大 或 缩小 。 
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9.1.5 KEME 


默认 情况 下 ，Google Maps 是 以 地 图 视图 来 显示 的 ， 它 基本 上 搬 绘 了 感 兴趣 的 街道 和 地 方 。 
还 可 以 使 用 MapView 类 的 setSatellite0) 方 法 将 Google Maps 设 置 为 以 卫星 视图 显示 。 


QOverride 
public void onCreate(Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


mapView = (MapView) findViewById(R.id.mapView); 
mapView.setBuiltInZoomControls (true); 


mapView.setSatellite(true); 


图 9-8 展 示 了 以 卫星 视图 显示 的 Google Maps. 
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显示 出 来 )。 图 9-9 展 示 了 分 别 以 街道 视图 ( 堪 ) 和 卫星 视图 ( 右 ) 显 示 一 个 位 置 的 地 图 。 


QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


mapView — (MapView) findViewById(R.id.mapView); 
mapView.setBuiltIiInZoomControls (true); 
mapView.setSatellite(true); 


mapView.setStreetView(true); 


284 


第 9 章 ”基于 位 置 的 服务 


如 果 想 要 在 地 图 上 显示 交通 状况 ， 使 用 setTraffic() 方 法 : 


mapView.setTraffic (true); 
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图 9-10 所 示 的 地 图 上 显示 了 当前 的 交通 状况 。 不 同 的 
颜色 反映 不 同 的 交通 状况 。 一 般 来 说 ， 绿 色相 当 于 约 每 小 
时 50 炎 里 的 车 速 ， 交 通 比 较 顺 畅 ， 黄色 相当 于 约 每 小 时 
25 一 50 天 里 的 和 车速， 交通 状况 中 等 ， 红色 相当 于 低 于 约 每 
小 时 25 英 里 的 车 速 ， 交 通 比 较 拥 堵 。 

注意 ， 随 独 新 的 国家 和 城市 不 断 加 入 ， 仅 仅 美 国 、 法 
国 、 英 国 、 澳 大 利 亚 以 及 加 拿 大 的 主要 城市 提供 交通 状况 
信息 。 


9.1.6 导航 到 特定 位 置 


BATUR. "Google Maps 首 次 加 载 时 ， 显 示 的 是 
美国 地 图 。 然 而 ， 也 可 以 将 Google Maps 设 置 为 显示 一 个 
特定 的 位 置 。 在 这 种 情况 下 ， 可 以 使 用 MapController 类 的 
animateTo() 方 法 。 

下 面 的 “ 试 一 试 ” 同 您 展示 了 如 何以 编程 方式 将 
Google Maps 动 画 显示 到 一 个 特定 位 置 。 9-10 


(1) 使 用 在 前 面 的 活动 中 创建 的 项 目 ， 在 MainActivity java 文 件 中 添加 下 列 粗 体 显示 的 语句 
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package net.learn2develop.LBS; 


import 
import 
import 
import 
import 


import 


import 


public 


android.app.Activity; 
android.os.Bundle; 
android.view.KeyEvent; 
com.google.android.maps.MapActivity; 
com.google.android.maps.MapController; 


com.google.android.maps.MapView; 


com.google.android.maps.GeoPoint; 


class MainActivity extends MapActivity { 


MapView mapView; 
MapController mo; 
GeoPoint p; 


/** HAR ARROEN Ao */ 


Override 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


mapView = (MapView) findViewById(R.id.mapView); 


mapView.setBuiltlInZoomControls (true); 


/ /mapView.setSatellite(true); 


mapView.setStreetView (true); 


mc — mapView.getController(); 

String coordinates[] = ("1.352566007", "103.78921587"); 
double lat - Double.parseDouble(coordinates[0]); 

double lng = Double.parseDouble(coordinates[1]); 


p = new GeoPoint( 
(int) (lat * 1E6), 
(int) (lng * 1E6)); 


mc.animateTo (p); 
mc.setZoom(13); 


mapView.invalidate(); 


public boolean onKeyDown(int keyCode, KeyEvent event) 


{ 


MapController mc = mapView.getController(); 
switch (keyCode) 
{ 

case KeyEvent.KEYCODE 3: 
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mc.zoomIn(); 
break; 
case KeyEvent.KEYCODE 1: 


mc.zoomOut(); 


break; 
} 
return super.onKeyDown(keyCode, event); 
} 
QOverride 


protected boolean isRouteDisplayed() I 
// TODO Auto-generated method stub 


return false; 


(2) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 当 地 图 被 加 载 后 ， 可 注意 到 它 动画 显示 到 新 
加 坡 的 一 个 特定 位 置 ( 如 图 9-11 所 示 )。 


- 5555GongleAFIs 2,2 Emulator 
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示例 说 明 


在 前 面 的 代码 中 ， 首 先 从 MapView 实 例 中 获取 一 个 地 图 控制 器 并 将 其 赋 给 一 个 MapController 
对 象 (mc)。 然 后 使 用 一 个 GeoPoint 对 象 来 代表 一 个 地 理 位 置 。 注 意 ， 对 于 GeoPoint 类 ， 一 个 位 
置 的 经 度 和 纬度 是 用 微 度 来 表示 的 。 这 意味 看 它们 是 以 整数 值 存 储 。 例 如 ， 对 于 一 个 纬度 值 
40.747778， 需 要 乘 以 le6(10 的 6 次 方 ， 一 百 万 ) 得 到 40747778。 

要 将 地 图 导航 到 特定 位 置 ， 可 以 使 用 MapController 类 的 animateTo() 方 法 。setZoom() 方 法 可 
以 用 来 指定 显示 地 儿 所 采用 的 缩放 级 别 (数字 越 大 ， 地 疼 上 就 能 显示 更 多 细节 )。 invalidate) 77 1X: 
D il 22 MapView. 
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9.1.7 添加 标记 


在 地 图 上 添加 标记 来 指明 感 兴趣 的 位 置 ， 这 样 可 以 使 用 户 很 容易 地 定位 他 们 所 要 查找 的 地 
方 。 下 面 的 “ 试 一 试 ” 展 示 了 如 何在 Google Maps 上 添加 标记 。 


在 地 图 上 添加 标记 


(1) 创建 一 个 包含 一 个 图 钉 的 GIF 图 像 ( 如 图 9-12 所 示 )， 并 将 其 复制 到 项 目的 res/drawable- 
mdpi 文 件 夹 下 。 为 达到 最 好 效果 ， 将 图 像 背 景 变 为 透明 ， 以 防止 添加 其 后 会 名 挡 住 部 分 地 图 。 
(2) 使 用 先前 的 活动 中 创建 的 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


4 d» res 
b [E drawable-hdpi 
b EE drawable-Idpi 
4 [— drawable-mdpi 
import android.app.Activity; IE] icon.png 
国 pushpin. gif — — — — 
4 [— layout 
[X| main.xml 
b [£2 values 


package net.learn2develop.LB35; 


import android.os.Bundle; 


import android.view.KeyEvent; 
图 9-12 

import com.google.android.maps.GeoPoint; 

import com.google.android.maps.MapActivity; 

import com.google.android.maps.MapController; 


import com.google.android.maps.MapView; 


import android.graphics.Bitmap; 

import android.graphics.BitmapFactory; 
import android.graphics.Canvas; 

import android.graphics.Point; 

import com.google.android.maps.Overlay; 
import java.util.List; 


public class MainActivity extends MapActivity [( 
MapView mapView; 
MapController mc; 


GeoPoint p; 


class MapOverlay extends com.google.android.maps.Overlay 
i 
GOverride 
public boolean draw(Canvas canvas, MapView mapView, 
boolean shadow, long when) 


{ 


super.draw(canvas, mapView, shadow); 
//--- 将 GeoPoint 转 换 为 屏幕 像素 --- 
Point screenPts - new Point(); 


mapView.getProjection().toPixels(p, screenPts); 


//--- 添 加 标记 --- 
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Bitmap bmp = BitmapFactory.decodeResource( 
getResources(), R.drawable.pushpin); 
canvas.drawBitmap (bmp, screenPts.x, screenPts.y-50, null); 


return true; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate(Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


mapView = (MapView) findViewById (R.id.mapView); 


mapView.setBuiltInZoomControls (true); 


//mapView.setSatellite(true); 


/ /mapView.setStreetView(true); 


mc = mapView.getController(); 
String coordinates[] = ["1.352566007", "103.78921587"); 
double lat = Double.parseDouble(coordinates[0]); 


double lng = Double.parseDouble(coordinates[ll);: 


p = new GeoPoint( 
(int) (lat * IEO), 
(int) (ling * 1E6)); 


mc.animateTo (p); 


mc.setzoom(13); 


//--- 添 加 一 个 位 置 标 记 --- 

MapOverlay mapOverlay = new MapOverlay(); 
List«Overlay» listOfOverlays = mapView.getOverlays(); 
listOfOverlays.clear(); 
listOfOverlays.add(mapOverlay); 


mapView.invalidate(); 


public boolean onKeyDown(int keyCode, KeyEvent event) 
1 
MapController mc = mapView.getController(); 
switch (keyCode) 
{ 
case KeyEvent.KEYCODE 3: 
mc.zoomIn(í); 
break; 
case KeyEvent.KEYCODE 1: 


mc.zoomOut(); 
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break; 
} 
return super.onKeyDown(keyCode, event); 
} 
QOverride 
protected boolean isHRouteDisplayed() { 
// TODO Auto-generated method stub 


return false; 
) 


(3) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 图 9-13 显 示 了 添加 到 地 图 上 的 标记 。 


ii 3556 GpogleAPE 2.2 Emulator 
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示例 说 明 
为 了 在 地 图 上 添加 标记 ， 衣 先 需 要 定义 一 个 扩展 Overlay 拓 的 拓 : 


class MapOverlay extends com.google.android.maps.Overlay 
{ 
QOverride 
public boolean draw(Canvas canvas, MapView mapView, 
boolean shadow, long when) 
{ 
"S ee 


} 


履 盖 代表 可 以 在 地 图 上 绘制 的 单独 的 一 项 。 可 以 添加 任意 多 个 覆盖 。 在 MapOverlay 类 中 ， 
重 写 draw() 方 法 ， 这 样 就 可 以 在 地 图 上 绘制 出 图 钉 图 像 。 特 别 要 注意 的 是 ， 需 要 将 地 理 位 置 (由 
GeoPointX] £? pzér ) Fc T JV BE a AI by : 


/V--- 将 GeoPoint 转 换 为 屏幕 像素 --- 


Point screenPts = new Point(); 
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mapView.getProjection().toPixels(p, screenPts); 


因为 想 让 图 钉 的 钉 尖 来 指示 地 点 的 具体 位 置 ， 所 以 需要 从 这 个 点 (如 图 9-14 所 示 ) 的 y 坐 标 扣 
除 图 像 的 高 度 (50 像 素 )， 并 在 该 位 置 绘 制图 像 : 
绘制 图 像 的 点 


screenPts.x, screenPts.vy-50 


a3creenPts.X, SscreenPts.vY 


点 的 位 置 
图 9-14 
//--- 添 加 标记 --- 
Bitmap bmp = BitmapFactory.decodeResource( 
getResources(), R.drawable.pushpin); 
canvas.drawBitmap (bmp, screenPts.x, screenPts.y-50, null); 


要 添加 标记 ， 创 建 MapOverlay 类 的 一 个 实例 并 把 它 添加 到 MapView 对 象 的 可 用 窗 新 列表 中 : 


//--- 添 加 一 个 位 置 标记 --- 

MapOverlay mapOverlay = new MapOverlay(); 
List«Overlay» listOfOverlays = mapView.getOverlays(); 
listOfOverlays.clear(); 
listOfOverlays.add(mapOverlay); 


9.1.8 获取 触摸 的 位 置 


使 用 Google Maps 一 段 时 间 之 后 ， 您 想 知 道 刚刚 在 屏幕 上 触 碰 到 的 位 置 对 应 地 点 的 经 纬 
上 度 。 知 道 这 个 信息 非常 有 用 ， 因 为 Morin 以 确 定 一 个 位 置 的 地 址 。 这 一 过 程 被 称 为 反问 地 理 
编码 (我 们 将 在 9.1.9 节 学 习 如 何 做 到 这 一 点 )。 

如 果 已 经 在 地 图 上 添加 了 一 个 黎 辣 ， 可 以 在 MapOverlay 类 中 重 写 onTIouchEvent(0 方 法 。 每 次 用 
户 触摸 地 图 时 都 会 触发 这 一 方法 。 此 方法 有 两 个 参数 : MotionEvent 和 MapView。 使 用 MotionEvent 
参数 ， 可 以 利用 getAction() 方 法 来 判断 用 户 是 否 已 经 从 屏幕 上 抬 起 了 他 /她 的 手指 。 在 下 面 的 代码 片 
段 中 ， 如 果 用 户 触 肆 了 屏 医 ， 随 即 又 抬 起 了 手指 ， 那 么 将 显示 出 所 触 肆 位 置 对 应 的 经 度 和 纬度 。 


import android.view.MotionEvent; 
import android.widget.Toast; 
fas. 


class MapOverlay extends com.google.android.maps.Overlay 
1 
QOverride 
public boolean draw(Canvas canvas, MapView mapView, 
boolean shadow, long when) 
{ 


super .draw (canvas, mapView, shadow); 
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//--- 将 GeoPoint 转 换 为 屏幕 像素 --- 
Point screenPts = new Point(); 


mapView.getProjection().toPixels(p, screenPts); 


/ / -— RW --- 


Bitmap bmp = BitmapFactory.decodeResource( 
getResources(), R.drawable.pushpin); 


canvas.drawBitmap (bmp, screenPts.x, screenPts.y-50, null); 


return true; 


} 
QOverride 
public boolean onTouchEvent(MotionEvent event, MapView mapView) 
i 
//--- 当 用 户 抬 起 手指 时 --- 
if (event.getAction() == 1) ( 
GeoPoint p = mapView.getProjection().fromPixels( 
(int) event.getX(), 
(int) event.getY()); 
Toast.makeText(getBaseContext(), 
"Location: "+ 
p.getLatitudeE6() / 1E6 + "," + 
p.getLongitudeE6() /1E6 , 
Toast.LENGTH SHORT).show(); 
] 
return false; 
] 


) 
getProjection() J ARH —^ Hd T YE BEAS- B xs AA a TZ 2 REA s Z7 [8] ETT PERIERE. 2A 


后 ，fromPixels(0) 方 法 将 屏幕 坐标 转换 成 GeoPoint 对 象 。 
图 9-15 展 示 了 当 用 户 单 击 地 图 上 一 个 位 置 时 所 显示 的 一 组 坐标 。 
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9.1.9 地 理 编码 和 反问 地 理 编码 


正如 9.1.8 节 所 述 ， 如 果 知 道 某 个 位 置 的 纬度 和 经 度 ， 就 可 以 使 用 一 个 称 为 反 回 地 理 编 码 的 
过 程 来 找到 它 的 地 址 。Android 中 的 Google Maps 是 通过 Geocoder 类 来 文 持 这 一 点 的 。 下 面 的 代码 
片段 展示 了 如 何 利用 getFromLocation0 方 法 来 获取 您 刚刚 所 触 们 位置 的 地 址 : 


import android.location.Address; 
import android.location.Geocoder; 
import java.util.Locale; 

import java.io.IOException; 


s 


aOverride 
public boolean onTouchEvent (MotionEvent event, MapView mapView) 
1 
//--- 当 用 户 抬 起 手指 时 --- 
if (event.getAction() == 1) { 
GeoPoint p = mapView.getProjection().fromPixelsq( 
(int) event.getX(), 
(int) event.getY()); 
F* 
Toast.makeText (getBaseContext (), 
"Location: "+ 
p.getLatitudeE6() / 1E6 + "," 十 
p.getLongitudeE6() /1E6 , 
Toast.LENGTH SHORT).show(); 
*y 


Geocoder geoCoder - new Geocoder( 
getBaseContext(), Locale.getDefault()); 
try { 
List«Address» addresses = geoCoder.getFromLocation( 
p.getLatitudeE6() / 1E6, 
p.getLongitudeE6() / 1E6, 1); 


String add = ""; 


if (addresses.size() > 0) 


{ 
for (int i-0; i«addresses.get(0). 
getMaxA ddressLinelndex(); i++) 
add += addresses.get(0).getAddressLine(i) + "Mn"; 
] 


Toast.makeText(getBaseContext(), add, Toast. 
LENGTH SHORT).show(); 

} 

catch (IOException e) ( 
e.printStackTrace(); 

} 


return true; 
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return false; 


GeocoderX 5 fii Hl getFromLocation() 7; 14:4 £$ B£ 402b Rz e p —^ p Sb. — Ho 3k em bz 

， 使 用 Toast 类 来 显示 它 。 图 9-16 展 示 了 应 用 程序 显示 在 地 图 上 所 触 碰 位 置 的 地 址 。 

如 果 知 道 一 个 位 置 的 地 址 ， 但 想 要 知道 它 的 经 度 和 纬度 ， 那 么 可 以 通过 地 理 编 伍 
做 到 这 一 点 。 同 样 ， 要 达到 此 目的 ， 可 以 使 用 Geocoder 类 。 下 面 的 代码 读 示 了 如 何 利用 
getFromLocationName() 方 法 来 获取 和 带 国 大 厦 的 准确 位 置 : 


/ / ---geo-coding--- 
Geocoder geoCoder = new Geocoder(this, Locale.getDefault()); 
try 1 
List«Address» addresses = geoCoder.getFromLocationName ( 
"empire state building", 5); 


String add = ""; 
if (addresses.size() > 0) { 
p = new GeoPoint( 
(int) (addresses.get(0).getLatitude() * 1E6), 
(int) (addresses.get(0).getLongitude() * 1E6)); 
mc.animateTo (p); 
mapView.invalidate(); 
] 
} catch (IOException e) | 


e.printStackTrace(); 
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9.2 获取 位 置 数 据 


如 今 ， 移 动 设备 普遍 配备 了 GPS 接 收 器 。 由 于 有 许多 卫星 绕 地 球 运行 ， 因 此 使 用 GPS 接 收费 
可 以 很 容易 找到 您 所 在 的 位 置 。 然 而 ，GPS 工 作 时 要 求 在 空旷 的 地 方 ， 因 此 在 室内 或 卫星 无 法 罕 
EAEN ONF BAN), GPS A EAH 

3 — BH FEMRA ATARE R R SAMA KEE EANG, ER 
不 断 地 与 其 周围 的 基站 联系 。 在 知晓 发 射 塔 的 标识 后 ， 通 过 使 用 含有 发 射 塔 的 标识 和 它们 所 处 
的 确切 地 理 位 置 的 各 种 数据 库 ， 可 以 将 这 一 信息 转换 为 物理 位 置 。 发 射 塔 三 角 测量 法 的 优点 是 
在 室内 也 起 作用 ， 无 须 获得 来 自卫 星 的 信息 。 然 而 ， 由 于 该 方法 的 准确 性 取决 于 重 释 信号 的 窟 
盖 范 围 ， 其 变化 相当 多 ， 因 此 它 不 如 GPS 来 得 精确 。 发 射 塔 三 角 测 量 法 在 人 口 稠 密 地 区 最 为 有 
效 ， 因 为 那里 的 发 射 塔 离 得 很 近 。 

第 三 种 定位 方法 是 依 菲 Wi-Fi 三 角 测量 法 。 设 备 连 接 到 Wi-Fi 网 络 而 不 是 连接 到 发 射 培 ， 并 
对 照 数 据 库 来 确定 服务 提供 商 所 服务 的 位 置 。 这 里 所 描述 的 3 种 方法 中 ，Wi-Fi 三 角 测 量 法 是 最 
不 准确 的 。 

Android SDK 提 供 了 LocationManager 类 ， 可 帮助 您 的 设备 确定 用 户 的 物理 位 置 。 下 面 的 “ 试 
一 试 ” 展 示 了 如 何 用 代码 做 到 这 一 点 。 


使 用 LocationManager 类 将 地 图 导航 到 特定 位 置 


(1) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.LBS; 


import android.app.Activity; 
import android.content.Context; 
i 

P e 


import android.location.Location; 
import android.location.LocationListener; 


import android.location.LocationManager; 


public class MainActivity extends MapActivity 1 
MapView mapView; 
MapController mc; 


GeoPoint p; 


private LocationManager lm; 


private LocationListener locationListener; 
class MapOverlay extends com.google.android.maps.Overlay 
1 
VIT 
} 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


Zu 


Android2mg fe AT ]25 Bà 


QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


mapView — (MapView) findViewById(R.id.mapView); 


mapView.setBuiltIiInZoomControls (true); 
mc = mapView.getController(); 


//--- 首 先导 航 到 一 个 点 --- 
String coordinates[] = ["1.352566007", "103.78921587"); 
double lat = Double.parseDouble(coordinates[0]); 
double lng = Double.parseDouble(coordinates[l]l); 
p = new GeoPointq( 
(int) (lat * IE), 
(int) (l1ng * 1E6)); 
mc.animateTo (p); 


mc.setZoom(13); 


/ | -- RI— AERC- 
7) 
//--- 反 向 地 理 编码 --- 


//--- 使 用 LocationManager 类 来 获取 位 置 数据 --- 
lm = (LocationManager) 
getSystemService (Context.LOCATION SERVICE); 


locationListener = new MyLocationListener(); 


lm.requestLocationUpdates 人 
LocationManager.GPS PROVIDER, 
0, 
0, 


locationListener); 


private class MyLocationListener implements LocationListener 
{ 
GOVwerIae 
public void onLocationChanged (Location loc) { 
if (loc !- null) { 
Toast.makeText(getBaseContext(), 
"Location changed : Lat: " + loc.getLatitude() + 
" Lng: " + loc.getLongitude(), 
Toast.LENGTH SHORT) . show () ; 


p = new GeoPoint( 
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(int) (loc.getLatitude() * 1E6), 
(int) (loc.getLongitude() * 1E6)); 


mc.animateTo (p); 


mc.setZoom(18); 


(Override 
public void onProviderDisabled(String provider) ( 
] 


((Override 
public void onProviderEnabled(String provider) { 
} 


((Override 


public void onStatusChanged(String provider, int status, 
Bundle extras) { 


public boolean onKeyDown(int keyCode, KeyEvent event) 


{ 

Pfess 
] 
QOverride 


protected boolean isRouteDisplayed() { 
// TODO Auto-generated method stub 


return false; 


| (8 DDMS - LBS/src/net/learn2develop/LBS/MainActivity.java - 
File Edit Run Source Refactor Navigate Search P 
r1- HRÈ E. E Js 
(2) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 e D oa 
p > E 
Devices 2i ~ m 
*|sss|27|o|lHM" 


(3) 为 了 模拟 Android 模 拟 咒 收 到 的 GPS 数据 ， 可 以 使 用 
DDMS 透 视图 中 的 Location Controls 工 具 ( 如 图 9-18 所 示 )。 dee 


> | HTO7YPY09335 Online 
(4) 前 先 确保 已 经 在 Devices 选 项 卡 中 选中 了 模拟 器 ， 然 后 ”| 对 
在 Emulator Control 选 项 卡 中 找到 Location Controls 工具， 选择 | uei TERT 


com.android.launche 123 


ManualiX 项 卡 o 输入 经 度 和 zh RE , IR 后 TR. i | i Send1Z fH o com.android.settings. 128 


com.google.process,c 169 


(5) 现在 可 观察 到 模拟 器 上 的 地 图 动画 显示 到 另 一 个 位 置 “ 一 人 ee 一 
(如 图 9-19 所 示 )。 这 证 明 应 用 程序 已 经 收 到 了 GPS 数据 。 — 


i& Decimal 

D Sexagesimal 
Longitude | -122.084095 
Latitude — 37422006 


图 9-18 
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" 5554 GoogleAPIs 2.2 Emulator 


B Location changed : Lat: 37.422006 Lng: 
| -122.084095 


A [s Dre ja. 
Eel jx civ 一 一 一 一 一 


pe iE er m 


示例 说 明 


在 Android 中 ， 基 于 位 置 的 服务 是 由 LocationManasger 类 提供 的 ， 位 于 android.location 包 中 。 
使 用 LocationManager 类 ， 应 用 程序 可 以 定期 获取 设备 的 地 理 位 置 的 更 新 ， 并 在 它 进 入 茶 个 位 置 
附近 时 触发 一 个 意图 。 
在 MainActivity.java 文 件 中 ， 首 先 使 用 getSystemService0 方 法 获取 一 个 指 加 LocationManasger 
关 的 引用 。 为 了 在 位 置 有 变化 时 得 到 通知 ， 需 要 注册 一 个 位 置 变化 的 请 求 ， 这 样 才 会 定期 地 通 
知 您 的 程序 。 这 是 通过 requestLocationUpdates(0) 方 法 来 完成 的 : 
lm.requestLocationUpdates( 
LocationManager.GPS PROVIDER, 
0, 
0, 


locationListener); 


这 个 方法 接受 4 个 参数 : 

您 所 注 册 的 服务 提供 商 的 名 称 。 在 本 例 中 ， 使 用 GPS 来 获取 地 理 位 置 数据 。 
进行 通知 的 最 短 时 间 间 隔 ， 用 守 秒 作为 单位 。 

€ minDistance 一 一 进行 通知 的 最 短 距 离 ， 用 米 作为 单位 。 

€ listener 一 个 对 象 ， 在 每 一 次 位 置 更 新 时 将 调用 其 onLocationChanged() 方 法 。 
MyLocationListener 类 实现 了 LocationListener 抽 和 象 类 。 在 该 实现 中 需要 重 与 以 下 4 个 方法 : 
€ onLocationChanged(Location location) 当 位 置 改变 时 调用 

€ onProviderDisabled(String provider) 一 一 当 提 供 商 被 用 户 禁 用 时 调用 

€ onProviderEnabled(String provider) 一 一 当 提 供 商 被 用 户 启用 时 调用 

€ onStatusChanged(String provider, int status, Bundle extras)—— 当 提供 商 状 态 改 变 时 调用 

在 这 个 例子 中 ， 我 们 对 于 一 个 位 置 变化 时 a 到 压 发 生 了 什么 更 感 兴趣 。 因 此 ， 可 以 在 onLocation- 


€ provider 
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Changed() 方 法 中 写 一 些 代码 来 看 一 下 。 具 体 来 说 ， 当 一 个 位 置 发 生变 化 时 ， 在 屏幕 上 会 显示 一 


个 小 的 对 话 框 来 表明 新 的 位 置信 息 : 经 度 和 纬度 。 可 以 使 用 Toast 类 显示 此 对 话 框 。 


如 果 想 使 用 Cell-ID 和 Wi-Fi 三 角 测 量 法 (对 于 室内 使 用 很 重要 ) 获 得 您 的 位 置 数 据 ， 那 么 可 以 


使 用 网 络 位 置 服务 提供 商 ， 如 下 所 示 : 
lm.requestLocationUpdates( 
LocationManager.NETWORK PROVIDER, 
0, 
0, 


locationListener); 
在 应 用 程序 中 ， 可 以 把 GPS 位 置 服务 提供 商 和 网 络 位 置 服务 提供 商 结 合 起 来 。 
监控 一 个 位 置 


LocationManager 类 的 一 个 非常 酷 的 功能 是 它 能 够 监视 一 个 特定 的 位 置 。 这 是 使 用 


addProximityAlert(O) 方 法 来 实现 的 。 下 面 的 代 码 片段 显示 了 如 何 监控 一 个 特定 位 置 。 如 条 用 户 位 


于 从 该 位 置 起 5 米 的 半径 内 ， 应 用 程序 将 触发 一 个 意图 来 月 动 Web 浏 览 需 : 


//--- 使 用 LocationManager 类 来 获取 位 置 数 据 --- 
lm = (LocationManager) 
getSystemService(Context.LOCATION SERVICE); 


//--- 如 果 用 户 正 处 于 某 个 位 置 ， 使 用 PendingIntent 来 调用 活动 --- 

PendingIntent pendIntent = PendingIntent.getActivity( 
this, 0, new 
Intent(android.content.Intent.ACTION VIEW, 


Uri.parse("http://www.amazon.com")), 0); 
lm.addProximityAlert(37.422006, -122.084095, 5, -1, pendIntent); 
addProximityAlert() 方 法 接受 5 个 参数 : 纬度 、 经 度 、 半 径 (以 米 为 单位 )、 有 效 期 限 (接近 警报 
的 有 效 时 间 ， 时 间 过 后 将 删除 和 警报; -1 表示 没有 有 效 期 限 )， 以 及 挂 起 的 意图 。 


注意 ， 如 果 Android 设 备 的 屏 攻 进入 睡眠 状态 ， 也 是 每 4 分 钟 检 碍 一 次 接近 状态 ， 这 样 可 以 


9.3 本章 小 结 


本 章 对 在 Android 应 用 程序 中 用 于 显示 Google Maps 的 MapView 对 象 进 行 了 大 致 的 了 解 。 我 
们 学 习 了 操作 地 图 的 不 同方 式 ， 还 学 习 了 如 何 使 用 不 同 的 网 络 服务 提供 商 来 获取 地 理 位 置 数 
据 : 采用 GPS、Cell-ID 和 Wi-Ei 三 角 测 量 法 。 
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1. 如果 您 在 Android 应 用 程序 中 能 入 了 Google Maps API， 但 在 应 用 程序 加 载 时 并 没有 显示 出 
地 图 ， 那 么 最 可 能 的 原因 有 哪些 ? 

2. ”地 理 编码 和 反 向 地 理 编码 有 何 区 别 ? 

3. ”说 出 可 用 于 获得 位 置 数据 的 两 个 位 置 服 务 提供 商 。 

4. ”监控 一 个 位 置 的 方法 是 什么 ? 


练习 答案 参见 附录 C。 


本 章 主要 内 容 


t B 关键 概念 


«com.google.android.maps.MapView 
android:id-"(M-id/mapView" 
android:layout width-"fill parent" 
显示 MapView android:layout height-"fill parent" 
android:enabled-"true" 
android:clickable-"true" 
android:apiKey-"OK2eMNyjc5HFPsiobLh6euLHb8F9ZPFmh4uIm7VTA" /> 


引用 Map 库 «uses-library android:name-"com.google.android.maps" /> 
显示 缩放 控件 mapView.setBuiltInZoomControls (true); 


E E — mc.zoomIn(í); 

UA Ss FE 7j IATH ANEITA 
mc.zoomoOut (); 
mapView.setSatellite(true); 

改变 视图 mapView.setStreetView(true); 


mapView.setTrafftic (true); 


mc — mapView.getController(); 

String coordinates[] = ["1.352566007", "103.78921587"]; 

double lat = Double.parseDouble(coordinates[0]); 

—hUm EiILGuL Md: p Em double lng = Double.parseDouble(coordinates[ll); 

动画 显示 到 一 个 特定 位 置 —— I 
(int) (lat * IlE6), 
(int) (ing * 1E6)); 


mc.animateTo (p); 


添加 标记 实现 一 个 Overlay 类 并 重 写 draw() 方 法 
GeoPoint p = mapView.dgetProjection().fromPixels( 
获取 在 地 图 上 触摸 的 位 置 (int) event.getX(), 


(int) event.getY()); 
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( 续 表 ) 
E 题 关键 概念 
地 理 编码 和 反 同 地 理 编码 ”使 用 Geocoder 关 


private LocationManager lm; 
a ES 


lm = (LocationManager) 


getSystemService (Context .LOCATION SERVICE); 
locationListener = new MyLocationListener(); 


lm.requestLocationUpdates ( 
LocationManager.GPS PROVIDER, 
0, 
Q » 


locationListener); 
I ss 


private class MyLocationListener implements LocationListener 
XI i 
获取 位 置 数据 
位 | GOverride 
public void onLocationChanged (Location loc) { 
if (loc != null) {ċ{ 
} 


QOverride 
public void onProviderDisabled(String provider) | 
} 


QOverride 
public void onProviderEnabled(String provider) { 
} 


QOverride 


public void onStatusChanged(String provider, 


int status, Bundle extras) { 


} 


监控 一 个 位 置 lm.addProximityAlert (37.422006, -122.084095, 5, -1, pendIntent); 
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本 章 将 介绍 以 下 内 容 
如 何 创 建 一 个 在 后 台 运 行 的 服务 
如 何在 一 个 单独 的 线程 中 执行 长 时 间 运 行 的 任务 
如 何在 一 个 服务 中 执行 重复 的 任务 
如 何在 活动 和 服务 间 进 行 通信 

服务 是 Android 中 一 个 在 后 台 运 行 的 应 用 程序 ， 它 无 须 与 用 户 进 行 交 互 。 例 如 ， 在 使 用 一 个 
应 用 程序 时 ， 您 可 能 想 要 在 同一 时 间 播 放 背 景 音 乐 。 在 这 种 情况 下 ， 播 放 背 景 音 乐 的 代码 驶 不 
需要 与 用 户 进行 交互 ， 因 此 它 可 以 作为 一 个 服务 来 运行 。 对 于 不 需要 加 用 户 展 示 用 户 界 面 的 情 
况 下 ， 使 用 服务 也 是 一 个 理想 的 选择 。 用 来 持续 记录 设备 所 在 地 理 坐 标的 应 用 程序 束 是 一 个 很 
好 的 示例 。 在 这 种 情况 下 ， 可 以 写 一 个 服务 在 后 人 台 执 行 任务 。 在 本 章 中 ， 将 介绍 如 何 创建 自己 
的 服务 以 及 利用 它们 来 异步 地 执行 后 从 任务 。 


10.1 创建 自己 的 服务 

理解 服务 如 何 工 作 的 最 好 方法 束 是 亲 目 创建 一 个 服务 。 下 和 面 的 “ 试 一 试 ” 癌 您 展示 了 创建 
一 个 简单 服务 的 步骤 。 后 续 章节 的 内 容 将 为 这 个 服务 增加 更 多 的 功能 。 至 于 现在 ， 先 学 习 如 何 
启动 和 停止 服务 。 


We 员 创建 一 个 简单 服务 


(1) 打开 Eclipse， 按 图 10-1 所 示 创 建 一 个 新 的 Android 项 目 。 
(2) 在 项 目 中 添加 一 个 新 的 名 为 MyService.java 的 类 文件 ， 其 中 的 代码 如 下 所 示 : 


package net.learn2develop.Services; 
import android.app.Service; 


import android.content.Intent; 
import android.os.IBinder; 
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import android.widget.Toast; 
public class MyService extends Service { 
üOverride 


public IBinder onBind(Intent argO) ( 


return null; 


NNNNA VN 


Override 

public int onStartCommand (Intent intent, int flags, int startId) ( 
// 我 们 希望 这 个 服务 在 被 显 式 停止 前 一 直 运行 ， 所 以 返回 “粘性 的 ”状态 。 
Toast.makeText(this, "Service Started", Toast.LENGTH LONG).show(); 
return START STICKY; 


8Override 
public void onDestroy() I 
super.onDestroy(); 
Toast.makeText(this, "Service Destroyed", Toast.LENGTH LONG).show(); 


B; New Android Project 


Mew Android Project 


Creates a new Android Project resource. 


Project name: Services 

Contents 

(à Create new project in workspace 
(C Create project from existing source 


Use default location 
Location; | G/Users/Wa-Meng Lee/Beginning Android/Services 
(CO Create project from existing sample 


Samples | AccelerometerPlay 


Build Target 


Target Name Vendor Platform 
[7] Android 21-upda.. Android Open Source Project 2 dl-upd.. 
[^] Google APE Google Ine. 21-upd.. 
[^] Android 2.2 Android Open Source Project t. 
[7] Google APE GoogleInc. 23 
E] GALAXY Tab Add... Samsung Electronics Co., Ltd. 22 
区 | Android 2.3 Ándroid Open Source Project 23 
[7] Google AFE Google Inc. LA 


Standard Android platform 2.3 


Properties 


Application name Services 


Package name: netlearnZdevel op.Services 
Create Activity: MainAcivity 


MinSDKVersion: 9 


Finish 


图 10-1 
(3) 在 AndroidManifest.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
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<?xml version-"1.0" encoding-"utfí-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Services" 
android:versionCode-"]" 
android:versionName-"1.0"- 
«application android:icon-"8(drawable/icon" android:label-"8string/app name" 
«activity android:name-".MainActivity" 
android:label-"Q8string/app name"» 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
Xservice android:name-".MyService" /» 
«/application» 
«uses-sdk android:minSdkVersion-"9" /> 
«/manifest» 


(4) 在 main.xml 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


«?xml version-"1.0" encoding-"utf-8"?- 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 

«Button android:id-"((xid/btnStartService" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Start Service" /» 

«Button android:id-"(txid/btnStopService'" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Stop Service" /» 

«/LinearLayout» 


(5) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.Services; 


import android.app.Activity; 


import android.os.Bundle; 


import android.content.Intent; 
import android.view.View; 


import android.widget.Button; 


public class MainActivity extends Activity { 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
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GOverride 
public void onCreate(Bundle savedInstanceState) 1 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


Button btnStart = (Button) findViewById(R.id.btnStartService); 
btnStart.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
startService (new Intent(getBaseContext(), MyService.class)); 


}):; 


Button btnStop = (Button) fidViewById(R.id.btnStopService); 
btnStop.setOnClickListener (new View.OnClickListener() ( 
publico void onClick(View v) ( 
stopService (new Intent (getBaseContext(), MyService.class)); 


}); 


(6) 按 Fl1 键 在 Android 模 拟 器 上 调试 应 用 程序 。 
(7) 单 击 Start Service 按 钮 将 局 动 服 务 ( 如 图 10-2 所 示 )。 要 停止 服务 ， 可 单 击 Stop Service 按 钮 。 


a 了 53353428ndroid 2.3 Emulator 


u wl È 1:57 


5tart Service 


图 10-2 
示例 说 明 
这 个 示例 展示 了 您 可 以 创建 的 最 简单 的 服务 。 当 然 ， 服 务 本 身 是 没有 做 什么 有 用 的 事情 ， 


但 它 足 以 说 明 整 个 创建 的 过 程 。 
首先 ， 它 定义 了 一 个 扩展 Service 基 类 的 类 。 所 有 服务 都 扩展 Service 类 : 
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public class MyService extends Service I 


) 
在 MyService 类 中 ， 实 现 了 3 个 方法 : 


QOverride 
public IBinder onBind (Intent arg0) [...] 


QOverride 
public int onStartCommand (Intent intent, int flags, int startId) {...} 


QOverride 
public void onDestroy() [(...! 


onBind() 方 法 可 以 用 来 将 一 个 活动 绑 定 到 一 个 服务 。 这 反 过 来 又 使 活动 可 以 直接 访问 服务 
内 部 的 成 员 和 方法 。 目 前 ， 只 是 为 这 个 方法 返回 null。 在 本 章 的 后 面 ， 您 将 学 习 更 多 有 关 绑 定 
的 内 容 。 

当 使 用 startService() 方 法 ( 稍 后 讨论 ) 显 式 启 动 服务 时 将 调用 onStartCommand() 方 法 。 这 个 方 
法 意味 看 服务 的 局 动 ， 并 为 服务 做 一 些 需 要 做 的 事情 。 此 方法 返回 音量 START_STICKY， 因 此 
只 要 服务 不 被 显 式 地 停止 ， 它 都 将 继续 运行 。 

当 使 用 stopService() 方 法 俘 止 服务 时 将 调用 onDestroy(0) 方 法 。 这 一 方法 将 清除 服务 所 使 用 的 

所 有 已 创建 的 服务 必须 在 AndroidManifest.xml 文 件 中 声明 ， 如 下 所 示 : 


«service android:name-".MyService" /> 
Ap ARAB LEE. HE PEU n] f FRE BR AS. RT EAS IET i 28MM E PETI S IR Hr de m» — 
下 所 示 : 


«service android:name-".MyService"» 
«intent-filter? 
«action android:name-"net.learn2develop.MyService" /> 
«/intent-filter^ 


«/service» 


要 启动 一 个 服务 ， 使 用 startService() 方 法 ， 如 下 所 示 : 

startService(new Intent (getBaseContext(), MyService.class)); 
如 果 调 用 一 个 外 部 服务 ， 要 按 如 下 所 示 调 用 startService() 方 法 : 

startService(new Intent("net.learn2develop.MyService")); 


要 停止 一 个 服务 ， 使 用 stopService0) 方 法 ， 如 下 所 示 : 


stopService (new Intent(getBaseContext(), MyService.class)); 
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在 服务 中 执行 长 时 间 运 行 的 任务 


由 于 在 上 一 亲 中 所 创建 的 服务 没有 做 任何 有 用 的 事情 ， 因 此 在 本 和 中 将 修改 这 一 服务 ， 使 
其 可 以 执行 一 个 任务 。 在 下 面 的 “ 试 一 试 ” 中 ， 将 模拟 一 个 从 Internet 上 下 载 文 件 的 服务 。 


使 服务 变 得 有 用 


(1) 使 用 在 前 一 节 中 所 创建 的 同一 个 项 目 ， 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 


语句 : 


package net.learn2develop.Services; 


import 
import 
import 


import 


import 
import 


public 


android.app.Service; 
android.content.Intent; 
android.os.IBinder; 


android.widget.Toast; 


java.net.MalformedURLException; 
jJava.net.URL; 


class MyService extends Service | 


QGOverride 
public IBinder onBind (Intent arg0) { 


return null; 


QOverride 
public int onStartCommand(Intent intent, int flags, int startId) 1 


// 我 们 希望 这 个 服务 在 被 显 式 停止 前 一 直 运 行 ， 所 以 返回 “ 粕 性 的 ”状态 。 


Toast.makeText(this, "Service Started", Toast.LENGTH LONG).show(); 


try ( 
int result = DownloadFile (new URL ("http://www .amazon.com/somefile .pd£")) ; 
Toast.makeText(getBaseContext(), 
"Downloaded " + result + " bytes", 
Toast.LENGTH LONG) . show () ; 
} catch (MalformedURLException e) { 
// TODO Auto-generated catch block 


e.printStackTrace(); 


} 

return START STICKY; 
] 
aOverride 


public void onDestroy() 1{ 


super.onDestroy(); 
Toast.makeText(this, "Service Destroyed", Toast.LENGTH LONG).show(); 
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private int DownloadFile (URL url) { 
try { 
//--- 模 拟 花 一 些 时 间 来 下 载 文件 --- 
Thread.sleep(5000); 
) catch (InterruptedException e) { 
e.printStackTrace(); 


} 
//--- 返 回 一 个 表示 下 载 文件 的 大 小 的 任意 数值 --- 


return 100; 


} 


(2) 按 F11 键 在 Android 模 拟 器 上 执行 应 用 程序 。 
(3) 单 击 Start Service 按 钮 启动 服 务 来 下 载 文件 。 可 以 看 a 到 活动 在 Toast 类 显示 Downloaded 100 
bytes 消 恩 之 前 被 “冻结 ”了 儿 秒 钟 (如 图 10-3 所 示 )。 


$YM |© — 


图 10-3 


示例 说 明 

在 这 个 示例 中 ， 服 务 调用 DownloadFile() 方 法 来 模拟 从 一 个 给 定 的 URL 下 载 文 件 。 此 方法 
返回 下 载 的 总 字 节 数 (已 经 便 编 码 为 100)。 为 了 模拟 下 载 文 件 时 服务 所 经 历 的 延迟 ， 使 用 Thread. 
Sleep) A 14 f TR 5-088 Fi 59b (50007 & Wb) . 

当局 动 服务 时 ， 可 以 注意 到 活动 被 暂停 了 大 约 5 秒 钟 ， 这 正 是 从 Internet 上 下 载 文件 的 时 间 。 
在 这 段 时 间 内 ， 整 个 活动 没有 啊 应 ， 这 证 明了 很 重要 的 一 点 : 服务 和 活动 在 相同 的 线程 上 运 
行 。 在 这 种 情况 下 ， 因 为 服务 暂 信 了 5 秒 钟 ， 所 以 活动 也 一 样 。 


因此 ， 对 十 一 个 长 时 间 运 行 的 服务 ， 将 所 有 长 时 间 运 行 的 代 人 码 放 入 一 个 单独 的 线程 中 是 很 重 
要 的 ， 这 样 服务 就 不 会 阻塞 调用 它 的 应 用 程序 了 。 下 面 的 “ 试 一 试 ” 将 告诉 您 如 何 做 到 这 一 点 。 
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在 服务 中 异步 执行 任务 


(1) 使 用 在 前 一 节 中 创建 的 同一 个 项 目 ， 在 MyService.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Services; 


import android.app.Service; 
import android.content.Intent; 
import android.os.IBinder; 
import android.util.Log; 


import android.widget.Toast; 


import java.net.MalformedURLException; 


import java.net.URL; 
import android.os.AsyncTask; 


public class MyService extends Service [ 
QOverride 
public IBinder onBind (Intent arg0) I 


return null; 


aOverride 
public int onStartCommand(Intent intent, int flags, int startId) { 
// 我 们 希望 这 个 服务 在 被 显 式 停止 前 一 直 运 行 ， 所 以 返回 “粘性 的 ”状态 。 
Toast.makeText(this, "Service Started", Toast.LENGTH LONG).show(); 
try i 
new DoBackgroundTask().execute( 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles.pdf")); 
} catch (MalformedURLException e) | 


e.printStackTrace(); 


} 

return START STICKY; 
} 
aOverride 


public void onDestroy() I 
super.onDestroy(); 
Toast.makeText(this, "Service Destroyed", Toast.LENGTH LONG).show(); 


private int DownloadFile(URL url) { 


try 1 
//--- 模 拟 花 一 些 时 间 来 下 载 文件 --- 
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Thread.sieep(5000); 

) catch (InterruptedException e) | 
e.printStackTrace(); 

} 

//--- 退 回 一 个 表示 下 载 文件 的 大 小 的 任意 数值 --- 


return 100; 


private class DoBackgroundTask extends AsyncTask«URL, Integer, Long» ( 
protected Long dolnBackground(URL... urls) 1 

int count - urls.length; 

long totalBytesDownloaded - 0; 

for (int i = 0; i < count; i++) 1 
totalBytesDownloaded += DownloadFile(urls[i]): 
//--- 计 算 下 载 的 百分比 并 报告 进度 --- 
publishProgress((int) (((i*1) / (float) count) * 100)); 

} 

return totalBytesDownloaded; 


protected void onProgressUpdate(Integer... progress) { 
Log.d("Downloading files", 
String.valueOf(progress[0]) + "$ downloaded"); 
Toast.makeText(getBaseContext(), 
String.valueOf(progress[0]) + "$ downloaded", 
Toast.LENGTH LONG).show(); 


protected void onPostExecute(Long result) { 
Toast.makeText(getBaseContext(), 
"Downloaded " + result + " bytes", 
Toast.LENGTH LONG).show(); 
stopSelf(); 


(2) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 
(3) 单 击 Start Service 按 钮 。Toast 类 将 显示 一 个 消 明 表明 下 载 完成 的 百分比 (如 图 10-4 所 示 )。 
可 以 看 到 4 个 值 : 25%、50%、75% 和 100%。 
(4) 还 可 以 看 到 在 LogCat 窗 口中 的 如 下 输出 内 容 : 
01-16 02:56:29.051: DEBUG/Downloading files(8844): 25$ downloaded 
01-16 02:56:34.071: DEBUG/Downloading files(8844): 50$ downloaded 


01-16 02:56:39.106: DEBUG/Downloading files(8844): 75$ downloaded 
01-16 02:56:44.173: DEBUG/Downloading files(8844): 100$ downloaded 
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& 3554:ÀAndroid 2.3 Emulator 


Start Service 


Stop Service 


25% downloaded 


示例 说 明 
这 个 示例 说 明了 可 以 在 您 的 服务 中 寞 步 执 行 任务 的 一 种 方法 。 通 过 创建 一 个 扩展 AsyncTask 关 
的 内 部 类 来 做 到 这 一 点 。AsyncTask 类 使 您 能 够 在 后 全 执行 ， 而 无 顷 手 动 操纵 线程 和 处 理 程 订 。 


DoBackgroundTask 类 通过 指定 3 个 泛 型 类 型 来 扩展 AsyncTask 类 ; 
private class DoBackgroundTask extends AsyncTask<URL, Integer, Long-»( 


这 里 指定 的 3 种 类 型 为 URL、Integer 和 Long。 这 3 种 类 型 指定 了 以 下 3 种 方法 所 用 到 的 数据 类 
型 ， 这 些 方 法 将 在 一 个 AsyncTask 类 中 来 实现 : 
e doInBackground()——3xX 方法 接受 一 个 先前 指定 的 第 一 个 泛 型 类 型 的 数组 。 在 这 里 ， 类 型 
是 URL。 这 个 方法 用 于 放置 需要 长 时 间 运 行 的 代码 并 在 后 台 线 程 中 执行 。 为 了 报告 任务 的 
进度 ， 调 用 publishProgress() 方 法 ， 它 将 调用 第 二 个 方法 onProgressUpdate0， 这 个 方法 在 一 个 
AsyncTask 类 中 实现 。 此 方法 的 返回 类 型 使 用 先前 指定 的 第 三 个 泛 型 类 型 ， 本 例 中 是 Long。 
€ onProgressUpdate() 这 一 方法 在 UI 线程 中 启动 并 在 调用 publishProgress() 方 法 时 调用 。 它 
接受 一 个 先前 指定 的 第 二 个 泛 型 类 型 的 数组 。 在 这 里 ， 类 型 是 Integer。 使 用 这 一 方法 回 用 户 
报告 后 台 任 务 的 进度 。 
€ onPostExecute() 这 一 方法 在 UI 线程 中 启动 并 在 doInBackeground() 方 法 执行 完毕 后 调用 。 
这 一 方法 接受 一 个 先前 指定 的 第 三 个 泛 型 类 型 的 参数 ， 本 例 中 是 Long。 
要 在 后 人 台 下 载 多 个 文件 ， 则 创建 DoBacksgroundTask 类 的 一 个 实例 ， 然 后 通过 传 入 一 个 URL 
数组 来 调用 其 execute() 方 法 : 


try 1 
new DoBackgroundTask () .execute (人 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
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new URL("http://www.learn2develop.net/somefiles.pdf")); 
} catch (MalformedURLException e) { 
// TODO Auto-generated catch block 


e.printsStackTrace(); 


前 述 的 代码 使 服务 在 后 全 下 载 文 件 ， 并 用 文件 下 载 的 百分比 形式 报告 进度 。 更 重要 的 是 ， 
当 在 后 台 通 过 一 个 单独 的 线程 下 载 文 件 时 ， 活 动 仍然 保持 啊 应 。 
注意 ， 当 后 人 台 线 程 执 行 完毕 时 ， 需 要 手动 调用 stopSelfO 方 法 来 停止 服务 : 


protected void onPostExecute(Long result) { 
Toast.makeText(getBaseContext (), 
"Downloaded ”+ result + " bytes", 
Toast.LENGTH LONG).show(); 
stopSelf(); 
) 


stopSelf() 方 法 相当 于 调用 stopService() 方 法 来 停止 服务 。 


10.1.2 在 服务 中 执行 重复 的 任务 


除了 在 服务 中 执行 长 时 间 运 行 的 任务 ， 一 些 重 复 的 任务 也 会 在 服务 中 执行 。 例 如 ， 您 可 能 
编写 了 一 个 一 直 在 后 从 进行 的 曾 钟 服务 。 在 这 种 情况 下 ， 服 务 可 能 党 要 定期 执行 一 些 代 公 来 检 
但 是 否 到 了 一 个 预 设 的 时 间 以 便 发 出 提醒 。 要 运行 一 个 按 固 定 的 时 间 间 隅 执行 的 代码 块 ， 可 以 
在 服务 中 使 用 Timer 类 。 下 面 的 “ 试 一 试 ” 将 告诉 您 怎么 做 。 


使 用 Timer 类 来 运行 重复 的 任务 


(1) 使 用 在 前 一 节 中 创建 的 同一 个 项 目 ， 在 MyService.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 
package net.learn2develop.Services; 


import android.app.Service; 
import android.content.Intent; 
import android.os.AsyncTask; 
import android.os.IBinder; 
import android.util.Log; 
import android.widget.Toast; 


import java.net.URL; 


import java.util.Timer; 
import java.util.TimerTask; 


public class MyService extends Service | 
int counter = 0; 
static final int UPDATE INTERVAL = 1000; 


private Timer timer - new Timer(); 
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QOverride 
public IBinder onBind (Intent arg0) I 


return null; 


(Override 


public int onStartCommand (Intent intent, 


// 我 们 希望 这 个 服务 在 被 显 式 停止 前 一 直 运 行 ， 
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int flags, int startId) { 


所 以 返回 “粘性 的 ”状态 。 


Toast.makeText(this, "Service Started", Toast.LENGTH LONG).show(); 


doSomethingRepeatedly (); 
return START STICKY; 


private void doSomethingRepeatedly() ( 


timer.scheduleAtFixedRate( new TimerTask() I 


public void run() { 


Log.d("MyService", String.valueOf(4Ttrcounter)); 


) 
), O, UPDATE INTERVAL); 
} 
dOverride 


public void onDestroy() I 
super.onDestroy(); 
if (timer !- null)( 
timer.cancel(); 


} 


Toast.makeText(this, "Service Destroyed", Toast.LENGTH LONG).show(); 


(2) 按 Fl11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 
(3) 单 击 Start Service 按 钮 。 
(4) 观察 在 LogCat 窗 口中 显示 的 输出 内 容 : 


01-16 15:12:04.364: DEBUG/MyService (495): 
01-16 15:12:05.384: DEBUG/MyService (495): 
01-16 15:12:06.386: DEBUG/MyService (495): 
01-16 15:12:07.389: DEBUG/MyService (495): 
01-16 15:12:08.364: DEBUG/MyService (495): 
01-16 15:12:09.427: DEBUG/MyService (495): 
01-16 15:12:10.374: DEBUG/MyService (495): 


~) Ow C1 Be wW N LP 


示例 说 明 


在 这 一 示例 中 ， 创 建 了 一 个 Timer 对 象 并 在 您 已 经 定义 
X] 2x JscheduleAtFixedRate() 77 7 : 


private void doSomethingRepeatedly() { 


的 doSomethineRepeatedly() 方 法 中 调 
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timer.scheduleAtFixedHRate(new TimerTask() 1 
public void run() I 
Log.d("MyService", String.valueOf(ttcounter)); 
) 
)], 0, UPDATE INTERVAL); 
] 


将 一 个 TimerTask 类 的 实例 传递 给 scheduleAtFixedRate(0) 方 法 ， 以 使 可 以 重复 执行 位 于 run0 方 
法 中 的 代 人 码 块 。scheduleAtFixedRate() 方 法 的 第 二 个 参数 指定 了 在 第 一 次 执行 之 前 的 时 间 间 隔 ， 
以 训 秒 为 单位 。 第 三 个 参数 以 训 秒 为 单位 ， 指 定 了 后 继 执行 之 间 的 时 间 间 隔 。 

在 前 面 的 示例 中 ， 基 本 上 每 1 秒 钟 (1000 曼 秒 ) 打 印 一 次 计数 器 的 值 。 这 一 服务 重复 打印 
counter 的 值 ， 直 到 服务 终止 。 


QOverride 
public void onDestrovy() { 

super.onDestroy(); 

if (timer !- null){ 

timer.cancel(); 

} 

Toast.makeText(this, "Service Destroyed", Toast.LENGTH LONG).show(); 
} 


对 于 scheduleAtFixedRate0 方 法 ， 不 管 每 个 任务 需要 多 长 时 间 ， 代 码 都 是 按照 固定 的 时 间 间 
隔 执行 。 例 如 ， 如 果 run0) 方 法 内 的 代码 需要 两 秒 钟 来 完成 ， 那 么 第 二 个 任务 将 在 第 一 个 任务 结 
束 后 立即 开始 。 同 样 ， 如 果 延 迟 时 间 设 置 为 3 秒 ， 而 完成 任务 只 需要 2 秒 ， 那 么 第 二 个 任务 在 开 
始 前 将 等 等 1 秒 钟 。 


10.1.3 使 用 IntentService 在 单独 的 线程 上 执行 异步 任务 


本 章 的 前 面部 分 讲述 了 如 何 使 用 startService() 方 法 局 动 服务 以 及 使 用 stopService0 方 法 停止 
服务 。 我 们 还 学 习 了 如 何在 一 个 单独 的 线程 上 执行 长 时 间 运 行 的 任务 一 一 与 主 调 活动 不 是 同一 
个 线程 。 重 要 的 是 需要 注意 ， 一 旦 服务 执行 守 任 务 ， 应 尽快 停止 ， 防 止 它 继续 占用 宝 贯 的 资 
源 。 这 就 是 为 什么 当 任 务 完成 时 需要 使 用 stopSelfO0 方 法 来 停 正 它 的 原因 。 簿 慑 的 是 ， 很 多 开 有 有 
人 员 在 任务 已 经 完成 后 稼 音 扎 记 将 服务 终止 。 为 了 能 较 容 易 地 创建 一 个 服务 ， 使 其 异步 运行 一 
个 任务 并 在 结束 时 自行 终止 ， 可 以 使 用 IntentService 类 。 

IntentService 类 是 可 以 按 需 处 理 异 步 请 求 的 Service 的 基 类 。 它 像 一 个 普通 服务 那样 启动 ， 在 
一 个 工作 者 线程 中 执行 其 任务 并 在 任务 完成 时 自行 终止 。 

FB *u—idXU ORI fsHIntntService25. 


使 用 IntentService 类 自动 停止 一 个 服务 


(1) 使 用 前 一 区 创建 的 同一 个 项 目 ， 这 加 一 个 新 的 类 文件 MyIntentService.java。 
(2) 在 MyIntentService.java 文 件 中 输入 以 下 内 容 : 
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package net.learn2develop.Services; 


import java.net.MalformedURLException; 
import java.net.URL; 


import android.app.IntentService; 
import android.content.Intent; 
import android.util.Log; 


public class MyIntentService extends IntentService { 


public MyIntentService() ( 
super("MyIntentServiceName"); 


lOverride 
protected void onHandleIntent(Intent intent) { 
try 1{ 
int result - 
DownloadFile (new URL ("http://www.amazon.com/somefile.pdf")); 
Log.d("IntentService", "Downloaded " + result + " bytes"); 
) catch (MalformedURLException e) 1 


e.printStackTrace(); 


private int DownloadFile(URL url) { 

try 1 
//--- 模 拟 花 一 些 时 间 来 下 载 文件 --- 
Thread.sleep(5000); 

) catch (InterruptedException e) 1 
// TODO Auto-generated catch block 
e.printStackTrace(); 

] 


return 100; 


(3) 在 AndroidManifestxml 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


<2Xml version-"1.0" encoding-"utf-8"?- 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 

package-"net.learn2develop.Services" 

android:versionCode-"]|" 

android:versionName-"1.0"» 

«application android:icon-"8(drawable/icon" android:label-"8string/app name"- 
«activity android:name-".MainActivity" 
android:label-"G8string/app name"» 
«intent-filter- 


«action android:name-"android.intent.action.MAIN" /» 
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«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 

«/activity» 

«service android:name-".MyService" /> 

«service android:name-".MyIntentService" /> 
«/application» 
«uses-sdk android:minSdkVersion-"9" /» 
«uses-permission android:name-"android.permission.INTERNET"» «/uses-permission» 


«/manifest-» 


(4) 在 MainActivity.java 文 件 中 讨 加 下 列 粗 体 显 示 的 语句 : 


public class MainActivity extends Activity 1{ 
/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 
QOverride 
public void onCreate(Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


Button btnStart = (Button) findViewById (R.id.btnStartService); 
btnStart.setOnClickListener(new View.OnClickListener() | 
public void onClick(View v) 1 
//startService (new Intent(getBaseContext(), MyService.class)); 
startService (new Intent(getBaseContext(), MyIntentService.class)); 


)); 
Button btnStop = (Button) findViewById(R.id.btnStopService); 
btnStop.setOnClickListener(new View.OnClickListener() I 


public void onClick(View v) 1 
stopService(new Intent(getBaseContext(), MyService.class)); 


)); 


(5) 按 F11 键 在 Android 模 拟 器 上 调试 应 用 程序 。 
(6) 单 击 Start Service 按 钮 。 大 约 5 秒 钟 之 后 ， 应 该 可 以 在 LogCat 窗 口中 观察 到 以 下 语句 : 


01-17 03:05:21.244: DEBUG/IntentService(692): Downloaded 100 bytes 


示例 说 明 
首先 ， 定 义 了 MyItentService 类 ， 它 扩展 IntentService 类 而 非 Service 类 : 


public class MyIntentService extends IntentService | 
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需要 实现 这 个 类 的 构造 函数 并 利用 意图 服务 的 名 称 (设置 为 一 个 字符 串 ) 调 用 其 父 类 : 


public MyIntentService() 1 
super ("MyIntentServiceName"); 


] 


然后 ， 实 现 onHandleIntent(0 方 法 ， 它 在 一 个 工作 者 线程 上 执行 : 


lOverride 
protected void onHandleIntent(Intent intent) | 
try { 
int result - 
DownloadFile (new URL ("http://www.amazon.com/somefile.pdf")); 
Log.d("IntentService", "Downloaded " + result + " bytes"); 
} catch (MalformedURLException e) { 
e.printStackTrace(); 
] 
] 


需要 在 一 个 单独 的 线程 中 执行 的 代码 可 以 放 在 onHandleIntent0 方 法 中 ， 如 从 服务 器 下 载 一 
个 文件 。 当 代码 执行 完毕 ， 线 程 被 终止 ， 并 且 服 务 上 自动 停止 。 


10.2 ”在 服务 和 活动 之 间 通 信 


服务 通常 只 是 在 自己 的 线程 中 执行 ， 独 立 于 调用 它 的 活动 。 如 果 您 只 是 想 让 服务 定期 执 
行 某 些 任务 并 且 不 需要 将 服务 的 状态 通知 给 活动 的 话 ， 这 并 不 造成 任何 问题 。 例 如 ， 您 可 能 ; 
一 个 将 设备 的 地 理 位 置 定 期 记录 到 数据 库 中 的 服务 。 在 这 种 情况 下 ， 您 的 服务 没有 必要 与 任何 
活动 进行 交互 ， 因 为 其 主要 目的 是 将 坐标 保存 到 数据 库 中 。 然 而 ， 假 设 您 想 监控 一 个 特定 的 位 
置 。 当 服务 记录 一 个 靠近 您 正在 监控 的 位 置 的 地 址 时 ， 它 可 能 需要 将 这 一 信息 传递 给 活动 。 在 
这 种 情况 下 ， 就 需要 为 服务 和 活动 的 交互 设计 一 种 方法 。 

下 面 的 “ 试 一 试 ” 展 示 了 服务 是 如 何 使 用 一 个 BroadcastReceiver 来 与 活动 通信 的 。 


从 一 个 服务 来 启动 一 个 活动 
(1) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 MyIntentService.java 文 件 中 添加 下 列 粗 体 显 示 的 
package net.learn2develop.Services; 
import java.net.MalformedURLException; 
import java.net.URL; 
import android.app.IntentService; 


import android.content.Intent; 


import android.util.Log; 
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public class MyIntentService extends IntentService | 
public MyIntentService() I 


super ("MyIntentServiceName"); 


QGOverride 
protected void onHandleIntent(Intent intent) [ 
try 1 


int result = 


DownloadFile (new URL("http://www.amazon.com/somefile.pdf")); 


Log.d("IntentService", "Downloaded ™ + result + " bytes"); 


//--- 发 送 一 个 广播 来 通知 活动 文件 已 经 被 下 载 --- 
Intent broadcastlIntent = new Intent(); 
broadcastiIntent.setAction("FILE DOWNLOADED ACTION"); 
getBaseContext().sendBroadcast(broadcastIntent); 

} catch (MalformedURLException e) { 


e.printStackTrace(); 


private int DownloadFile(URL url) { 
try 1 
//--- 模 拟 花 一 些 时 间 来 下 载 文件 --- 
Thread.sieep(5000); 
) catch (InterruptedException e) | 
e.printStackTrace(); 


} 


return 100; 


(2) fEMainActivity.java CFP ZRIN F ZH MS HUE: 
package net.learn2develop.Services; 


import android.app.Activity; 

import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 


import android.widget.Toast; 
import android.content.IntentFilter; 


public class MainActivity extends Activity { 
IntentFilter intentFilter; 


/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 


上 调试 应 用 程序 。 

(4) 单 击 Start Service 按 钮 。 大 
约 5 秒 钟 后 ，Toast 类 将 显示 一 个 消 
县 表明 文件 已 经 被 下 载 (如 图 10-5 


所 不 )。 
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QOverride 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//--- 用 来 第 选 文件 已 下 载 的 意图 --- 


intentFilter = new IntentFilter(); 
intentFilter.addAction("FILE DOWNLOADED ACTION"); 


//--- 注 册 接收 者 --- 


registerReceiver(intentReceiver, intentFilter); 


Button btnStart = (Button) findViewById(R.id.btnStartService); 
btnStart.setOnClickListener (new View.OnClickListener() 1 
public void onClick(View v) { 
//startService(new Intent (getBaseContext(), MyService.class)); 
startService (new Intent (getBaseContext (), MyIntentService.class)); 


H: 


Button btnStop = (Button) findViewById(R.id.btnS5Stop5ervice);} 
btnStop.setOnClickListener(new View.OnClickListener() | 
public void onClick(View v) { 


stopService(new Intent (getBaseContext(), MyService.class)): 


}) 7 


private BroadcastReceiver intentReceiver = new BroadcastReceiver() | 
Override 
public void onReceive (Context context, Intent intent) { 
Toast.makeText(getBaseContext(), "File downloaded!", 
Toast.LENGTH LONG).show(); 


} . a 5554 ndroid 之 3 Emulator 
F - —— 一 - 


(3) JZF1198£ fE Android 5:430 28 © e^ © © 
G E ^ 
2 / y Ur 
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i | 
e D A / 
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File downloaded! 
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示例 说 明 
为 了 在 一 个 服务 执行 结束 后 可 以 通知 一 个 活动 ， 需 要 使 用 sendBroadcast(O 方 法 广播 一 个 


GOverride 
protected void onHandleIntent (Intent intent) { 
try 1 


int result = 
DownloadFile (new URL("http://www.amazon.com/somefile.pdf")); 
Log.d("IntentService", "Downloaded " + result + " bytes"); 


//--- 发 送 一 个 广播 来 通知 活动 文件 已 经 被 下 载 --- 
Intent broadcastlIntent = new Intent(); 
broadcastlIntent.setAction("FILE DOWNLOADED ACTION"); 
getBaseContext().sendBroadcast(broadcastIntent); 

} catch (MalformedURLException e) { 


e.printStackTrace(); 


广播 的 这 一 意图 的 动作 被 设置 为 FILE DOWNLOADED _ ACTION， 这 意味 着 侦 听 这 
一 意图 的 任何 活动 都 将 被 调 有 用。 因此， 在 MainActivity.java 文 件 中 ， 使 用 IntentFilter 类 的 
registerReceiver(0) 方 法 来 侦 听 这 个 意 网 : 


QOverride 
public void onCreate(Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//--- 用 来 筛选 文件 已 下 载 的 意图 --- 

intentFilter - new IntentFilter(); 
intentFilter.addAction("FILE DOWNLOADED ACTION"); 
//--- 注 册 接收 者 --- 


registerReceiver(intentReceiver, intentFilter); 


当 收 到 这 一 意图 后 ， 它 将 启动 一 个 已 定义 的 BroadcastReceiver 类 的 实例 : 


private BroadcastReceiver intentReceiver = new BroadcastReceiver() | 
aOverride 
public void onReceive (Context context, Intent intent) | 
Toast.makeText(getBaseContext(), "File downloaded!", 
Toast.LENGTH LONG).show(); 
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HE. 第 8 章 详 细 讨 论 了 BroadcastReceiver 类 。 


在 本 例 中 ， 显 示 了 消息 “File downloaded! ”。 当 然 ， 如 果 需 要 从 服务 传递 一 些 数 据 给 活 


动 ， 可 以 使 用 Intent 对 象 。10.3 节 将 讨论 这 个 问题 。 


10.3 将 活动 绑 定 到 服务 


到 目前 为 止 ， 您 已 经 了 解 了 如 何 创建 服务 ， 如 何 调用 服务 以 及 任务 完成 后 如 何 终 止 服 
要 么 局 动 一 个 计数 器 并 以 固定 的 时 间 间 隔 递 增 ， 要 么 从 
Internet 上 下 载 一 组 固定 的 文件 。 然而 ， 现实 世界 中 的 服务 通 芝 更 为 复杂 ， 需要 传递 数据 来 使 它 


务 。 所 有 已 经 看 到 的 服务 都 很 简单 


们 为 您 正确 地 工作 。 

使 用 先前 展示 的 下 载 一 组 文件 的 服务 ， 假 设 现 在 想 让 主 调 活 动 来 决定 下 载 什 么 样 的 文件 ， 
而 不 是 在 服务 中 靠 便 编码 实现 ， 那 么 就 需要 按 以 下 方式 来 做 。 

首先 ， 在 主 调 活动 中 ， 创 建 一 个 mtent 对 象 ， 指 定 服务 名 称 : 


Button btnStart = (Button) findViewById(R.id.btnStartService); 
btnStart.setOnClickListener(new View.OnClickListener() [| 
public void onClick(View v) 1 
Intent intent - new Intent(getBaseContext(), MyService.class); 


)); 


然后 ， 创 建 一 个 URL 对 和 象 的 数组 ， 并 通过 Intent 对 象 的 putExtra(0) 方 法 将 其 赋 给 Intent 对 象 。 
最 后 ， 使 用 Intent 对 和 象 司 动 服 务 : 


Button btnStart = (Button) findViewById(R.id.btnStartService); 
btnStart.setOnClickListener(new View.OnClickListener() [| 
public void onClick(View v) 1 
Intent intent = new Intent (getBaseContext(), MyService.class); 
try { 
URL[] urls = new URLI[] ( 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http:/ /www.learn2develop.net/soamefiles .pd£") ) ; 
intent.putExtra("URLs", urls); 
) catch (MalformedURLException e) { 
e.printStackTrace(); 
} 


startService (intent); 
)): 


注意 ，URL 数 组 作为 一 个 Object 数 组 被 赋 给 了 Intent 对 象 。 
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QOverride 
public int onStartCommand(Intent intent, int flags, int startId) 1 


// 我 们 希望 这 个 服务 在 被 显 式 停止 前 一 直 运 行 ， 所 以 返回 “粘性 的 ”状态 . 


Toast.makeText(this, "Service Started", Toast.LENGTH LONG).show(); 


Object[] objUrls = (Obgect[]) intent.getExtras().get("URLs"); 
URL[] urls = new URL[objUrls.length]; 
for (int i-0; i«objUrls.length-1; i++) { 
urls[i] = (URL) obgUrls[i]; 
] 
new DoBackgroundTask().execute (urls); 
return STAKT STICKY; 


上 述 代 人 码 首 先 使 用 getExtras(0) 方 法 提取 数据 来 返回 一 个 Bundle 对 象 。 然 后 使 用 getO 方 法 以 
Object 数组 形式 提取 出 URL 数 组 。 由 于 在 Java 中 ， 不 能 直接 将 数组 从 一 个 类 型 转换 到 另 一 个 类 
型 ， 因 此 必须 创建 一 个 循环 ， 对 数组 中 的 每 个 成 员 单 独 进行 转换 。 最 后 ， 通 过 将 URL 数 组 传递 
给 execute() 方 法 来 执行 后 台 任 务 。 

这 是 活动 可 以 将 值 传 递 给 服务 的 一 种 方式 。 正 如 您 看 到 的 ， 如 果 要 将 比较 复杂 的 数据 传 
递 给 服务 ， 束 必须 做 一 些 额外 的 工作 ， 以 确保 数据 被 正确 传递 。 传 递 数据 的 一 个 更 好 的 办 法 是 
直接 将 活动 绑 定 到 服务 上 ， 这 样 活动 可 以 直接 调用 服务 的 任何 公共 成 员 和 方法 。 下 面 的 “ 试 一 
试 ” 展 示 了 如 何 将 活动 绑 定 到 服务 上 。 


直接 通过 绑 定 访问 属性 成 员 


(1) 使 用 先前 创建 的 同一 个 项 目 ， 在 MyService.java 文 件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Services; 


import 
import 


import 


import 
import 
import 
import 
import 


import 


import 


public 


java.net.URL; 
Java.util.Timer; 


java.util.TimerTask; 


android.app.Service; 
android.content.Intent; 
android.os.AsyncTask; 
android.util.Log; 
android.widget.Toast; 


android.os.IBinder; 


android.os.Binder; 


class MyService extends Service | 


int counter = 0; 
URL[] urls; 
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static final int UPDATE INTERVAL = 1000; 


private Timer timer = new Timer(); 


private final IBinder binder = new MyBinder(); 


public class MyBinder extends Binder { 


MyService getService() { 


return MyService.this; 


QOverride 
public IBinder onBind (Intent arg0) I 


//return null; 


return binder; 


QOverride 
public int onStartCommand(Intent intent, int flags, int startId) 1 


// 我 们 希望 这 个 服务 在 被 显 式 停止 前 一 直 运 行 ， 所 以 返回 “粘性 的 ”状态 。 
Toast.makeText(this, "Service Started", Toast.LENGTH LONG).show(); 
new DoBackgroundTask().execute (urls); 

return START STICKY; 


(QOverride 


public void onDestroy() I 


private int DownloadFile(URL url) 1 


private class DoBackgroundTask extends AsyncTask«URL, Integer, Long» [ 


(2) 在 MainActivity.java 文 件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Services; 


import 


import 


import 
import 


import 


java.net.MalformedURLException; 


java.net.URL; 


android.app.Activity; 
android.content.BroadcastHReceiver; 


android.content.ComponentName; 
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import android.content.Context; 
import android.content.Intent; 
import android.content.IntentFilter; 
import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 


import android.widget.Toast; 


import android.os.IBinder; 


import android.content.ServiceConnection; 


public class MainActivity extends Activity { 
IntentFilter intentFilter; 


private MyService serviceBinder; 


Intent i; 


private ServiceConnection connection = new ServiceConnection() | 
public void onServiceConnected (ComponentName className, IBinder service) { 
//--- 当 建立 连接 时 调用 --- 
serviceBinder - ((MyService.MyBinder)service).getService(); 
try 1 
URL[] urls = new URL[] { 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles .pdf£")); 
//--- 通 过 serviceBinder 对 象 将 URIL 赋 给 服务 --- 
serviceBinder.urls - urls; 
} catch (MalformedURLException e) 1 
e.printStackTrace(); 
} 
startService (i); 
] 
public void onServiceDisconnected(ComponentName className) { 
//--- 当 服务 断 开 时 调用 --- 


serviceBinder - null; 


}s 

/** 当 活 动 第 一 次 被 创建 时 调用 。 */ 

QOverride 

public void onCreate (Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


//--- 用 来 筛选 文件 已 下 载 的 意图 --- 
intentFilter = new IntentFilter(); 
intentFilter.addAction("FILE DOWNLOADED ACTION"); 


//--- 注 册 接 收 者 --- 
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registerReceiver (intentReceiver, intentFilter); 


Button btnStart = (Button) findViewById(R.id.btnStartService); 
btnStart.setOnClickListener(new View.OnClickListener() [| 
public void onClick(View v) 1 
i = new Intent(MainActivity.this, MyService.class); 
bindService(i, connection, Context.BIND AUTO CREATE); 


H); 


Button btnStop = (Button) findViewById(R.id.btnStopService); 
btnStop.setOnClickListener(new View.OnClickListener() 1{ 
public void onClick(View v) { 
stopService (new Intent (getBaseContext (), MyService.class)); 


(3) 按 F11 键 调试 应 用 程序 。 单 击 Start Service 按 钮 将 正常 启动 服务 。 
示例 说 明 
为 了 将 活动 绑 定 到 一 个 服务 ， 必 须 首 先 在 服务 中 声明 一 个 扩展 Binder 类 的 内 部 类 : 


public class MyBinder extends Binder I 
MyService getService() { 


return MyService.this; 


在 这 个 类 中 实现 getService() 方 法 ， 这 一 方法 返回 服务 的 
类 的 实例 : 


个 实例 。 然 后 创建 一 个 MyBinder 


private final IBinder binder = new MyBinder(); 
还 要 修改 onBind() 方 法 来 返回 MyBinder 实 例 : 


QOverride 

public IBinder onBind (Intent arg0) { 
//return null; 
return binder; 


] 
在 onStartCommand() 方 法 中 ， 使 用 先前 在 服务 中 作为 公共 成 员 声 明 的 urls 数 组 调用 execute() 


public class MyService extends Service I 
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int counter = 0; 
URL[] urls; 


QOverride 

public int onStartCommand(Intent intent, int flags, int startId) 1 
// 我 们 希望 这 个 服务 在 被 显 式 停止 前 一 直 运 行 ， 所 以 返回 “粘性 的 ”状态 。 
Toast.makeText(this, "Service Started", Toast.LENGTH LONG).show(); 
new DoBackgroundTask(í().execute (urls); 
return START STICKY; 


一 步 要 做 的 就 是 从 活动 中 直接 对 这 个 URL 数 组 进行 设置 。 
we 中 ， 首 先 声 明 服 务 的 一 个 实例 和 一 个 Intent 对 象 : 


private MyService serviceBinder; 


Intent 1i; 


serviceBinder 对 象 将 用 作 指 癌 服 务 的 引用 ， 可 以 直接 访问 它 。 
然后 创建 一 个 ServiceConnection 类 的 实例 以 便 监 控 服 务 的 状态 : 


private ServiceConnection connection = new ServiceConnection() { 
public void onServiceConnected (ComponentName className, IBinder service) | 
//--- 当 建立 连接 时 调用 --- 
serviceBinder = ((MyService.MyBinder)service).getService(); 
try 1 
URL[] urls = new URL[] { 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles.pdf")]); 
//--- 通 过 serviceBinder 对 象 将 URIL 赋 给 服务 --- 
serviceBinder.urls - urls; 
} catch (MalformedURLException e) 1 
e.printStackTrace(); 


) 


startService (i); 


} 


public void onServiceDisconnected (ComponentName className) { 
//--- 当 服务 断 开 时 调用 --- 


serviceBinder - null; 
}; 
需要 实现 两 个 方法 : onServiceConnected()fllonServiceDisconnected(). onServiceConnected() 77 1; 
是 当 活 动 连接 到 服务 时 调用 的 。 当 服 4 3 活动 断 开 时 调用 onServiceDisconnectedO 方 法 。 
fEonServiceConnected() 77 17; P 活动 连接 到 服务 时 ， 通 过 使 用 service 参 数 的 getService() 方 
法 ， 然 后 将 其 赋 给 serviceBinder 对 e. 获取 服务 的 一 个 实例 。serviceBinder 对 象 是 一 个 指 癌 服务 
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的 引用 ， 可 以 通过 这 一 对 象 访问 服务 的 所 有 成 员 和 方法 。 这 里 ， 创 建 了 一 个 URL 数 组 并 将 其 直 
接 赋 给 服务 中 的 公共 成 员 : 
URL[] urls = new URL[] { 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles.pdf")]); 


//--- 通 过 serviceBinqder 对 象 将 URIL 赋 给 服务 --- 


serviceBinder.urls = urls; 
然后 使 用 一 个 Intent 对 象 启动 服务 : 
startService(i); 

在 可 以 司 动 服务 之 前 ， 需 要 将 活动 绑 定 到 服务 。 这 个 在 Start Service 按 钮 的 onClick(O 方 法 中 
Button btnStart = (Button) findViewById(R.id.btnStartService); 
btnStart.setOnClickListener(new View.OnClickListener() [| 

public void onClick(View v) { 


i = new Intent(MainActivity.this, MyService.class); 
bindService(i, connection, Context.BIND AUTO CREATE); 


)):; 


bindService() 方 法 使 活动 与 服务 建立 了 连接 。 它 接受 3 个 参数 : 一 个 Inent 对 象 、 一 个 
ServiceConnection 对 象 以 及 一 个 用 来 指示 服务 绑 定 方式 的 标志 。 


10.4 本章 小 结 


在 本 章 中 ， 我 们 学 习 了 如 何在 Android 应 用 程序 中 创建 一 个 服务 来 执行 长 时 间 运 行 的 任务 。 
了 解 了 可 以 用 来 确保 后 台 任 务 以 异步 方式 执行 而 不 阻塞 主 调 活动 的 许多 方法 。 我 们 还 学 习 了 活 
动 是 如 何 给 服务 传递 数据 的 ， 以 及 如 何 绑 定 到 一 个 活动 ， 使 之 可 以 更 直接 地 访问 服务 。 


1. 为 什么 说 将 一 个 服务 中 的 长 时 间 运 行 的 代码 放 在 一 个 单独 的 线程 中 是 重要 的 ? 
2. ”IntentService 类 的 作用 是 什么 ? 

3. ”说 出 需要 在 一 个 AsyncTask 类 中 实现 的 3 个 方法 。 

4. ”服务 如 何 通知 活动 发 生 了 一 个 事件 ? 


练习 答案 参见 附录 C。 
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本 章 主 要 内 容 

主 m 
创建 一 个 服务 

在 一 个 服务 中 实现 方法 
启动 一 个 服务 
停止 一 个 服务 
执行 长 时 间 运行 的 任务 
执行 重复 的 任务 


在 一 个 单独 的 线程 中 执行 任务 
并 自动 停止 一 个 服务 


在 活动 和 服务 之 间 通 信 


将 活动 绑 定 到 服务 


关键 概念 

创建 一 个 类 并 扩展 Service 类 

实现 以 下 方法 ，onBindo、onStartCommandOo 和 onDestroy0) 
使 用 startService() 方 法 

使 用 stopService() 方 法 


使 用 AsyncTask 类 并 实现 3 个 方法 : dolnBackground(). onProgressUpdate() FN 
onPostExecute() 


使 用 Timer 类 并 调用 它 的 scheduleAtFixedRate() 方 法 
使 用 IntentService 类 


使 用 Intent 对 象 给 服务 传递 数据 。 对 于 一 个 服务 ， 广 播 一 个 mtent 来 通知 一 
个 活动 


在 服务 中 使 用 Binder 类 并 在 主 调 活动 中 实现 ServiceConnection 类 


发 布 Android 应 用 程序 


本 章 将 介绍 以 下 内 容 
e 如 何 为 部 署 应 用 程序 做 准备 
e 如何 将 应 用 程序 导出 为 一 个 APK 文 件 并 用 新 的 证 书 对 其 签名 
e ”如 何 分 发 Android 应 用 程序 
全 ”加 何在 Android Market 上 发 布 应 用 程序 

到 目前 为 止 ， 您 己 经 了 解 到 了 使 用 Android 可 以 做 很 多 有 趣 的 事情 。 然 而 ， 为 了 使 您 的 应 用 
程序 可 以 在 用 户 的 设备 上 运行 ， 需 要 一 个 方法 来 部 普 和 分 上 友 它 。 在 本 章 中 ， 将 学 习 如 何 为 部 署 
Android 旋 用 程序 做 准备 并 将 它们 转移 到 客户 设备 上 上。 此外， 还 将 学 习 如 何 将 您 的 应 用 程序 发 布 
到 Android Market 上 ， 在 那里 您 可 以 通过 出 售 应 用 程序 来 赚钱 ! 


11.1 为 发 布 做 准备 


Google 已 经 使 得 Android 习 用 程序 的 发 布 变 得 相当 容易 ， 因 此 可 以 很 迅速 地 将 其 分 发 给 终端 
用 户 。 发 布 Android 必 用 程序 的 步骤 通 彰 包 含 以 下 几 步 : 

(D) 将 应 用 程序 导出 为 一 个 APK(Android Package) X: f/f. 

(2) 生成 自己 的 自 签 名 证 书 并 用 它 对 应 用 程序 进行 数学 签名。 

(3) 部 署 签名 后 的 应 用 程序 。 

(4) 利用 Android Market 对 应 用 程序 进行 托管 和 出 售 。 

在 接 下 来 的 章节 中 ， 将 学 习 如 何 为 签署 应 用 程序 做 准备 ， 以 及 学 习 部 署 应 用 程序 的 不 同方 法 。 

本 章 中 将 使 用 在 第 9 章 创建 的 LBS 项 目 来 说 明 如 何 部 署 Android 应 用 程序 。 


11.1.1 版 本 化 


从 Android SDK 1.0 版 本 开始 ， 每 一 个 Android 应 用 程序 的 AndroidManifest.xml 文 件 都 包括 了 
android:versionCode 和 android:versionName 属 性 : 


<?xml version-"1.0" encoding-"utf-8"?- 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.LBS" 


android:versionCode-"1" 
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android:versionName="1.0"> 
«application android:icon="@drawable/icon" android:label-"8string/app name"> 
«uses-library android:name-"com.google.android.maps" /> 
«activity android:name-".MainActivity" 
android:label-"Q8string/app name"» 
«intent-filter- 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"7" /> 
«uses-permission android:name-"android.permission.INTERNET" /» 
«uses-permission android:name-"android.permission.ACCESS FINE LOCATION" /» 
«uses-permission android:name-"android.permission.ACCESS COARSE LOCATION" /> 


</manifest> 


android:versionCode 属 性 表示 了 应 用 程序 的 版 本 号 。 对 于 对 应 用 程序 所 做 的 每 一 次 修改 ， 
都 应 该 将 这 个 值 加 1， 以 便 可 以 以 编程 方式 来 区 分 先前 版 本 和 最 新 版 本 。Android 系 统 水 远 不 会 
使 用 这 个 值 。 但 对 于 开发 来 说 ， 这 是 一 个 获得 应 用 程序 版 本 号 的 很 有 用 的 方法 。 不 过 ，Android 
Market 使 用 android:versionCode 属 性 来 确定 应 用 程序 是 否 有 新 的 版 本 可 用 。 
可 以 使 用 PackageManager 类 的 getPackageInfo() 方 法 以 编程 方式 检索 android:versionCode 属 性 
的 值 ， 如 下 所 示 : 
PackageManager pm = getPackageManager(); 
try 1 
/ / - — —GRBBBS R--- 
PackageInfo pi - 
pm.getPackageInfo("net.learn2develop.LBS", 0); 


/ [| -— SR URNA -—— 
Toast.makeText(getBaseContext (), 
"VersionCode: " «Integer.toString(í(pi.versionCode), 
Toast.LENGTH SHORT).show(); 
} catch (NameNotFoundException e) { 
// TODO Auto-generated catch block 


e.printStackTrace(); 


android:versionName 属 性 包含 了 对 用 户 可 见 的 版 本 信息 。 它 应 该 以 <major>.<minor>.<point> 
格式 包含 值 。 如 果 应 用 程序 进行 了 重要 的 升级 ， 那 么 应 该 将 <major> 加 1。 对 于 微小 的 增 量 更 
新 ， 可 以 将 <mipor> 或 <poi 达 加 1。 例 如 ， 一 个 新 的 应 用 程序 的 版 本 名 称 是 1.0.0。 对 于 较 小 的 增 
量 更 新 ， 可 以 将 版 本 名 称 修改 为 1.1.0 或 1.0.1。 如 果 下 一 次 有 较 大 的 更 新 ， 可 以 将 其 变 为 2.0.0。 

如 果 计 划 在 Android Market(www.android.com/market/) E iw Hif. AndroidManifest.xml 
文件 必须 具有 以 下 属性 : 

€ android:versionCode( 位 于 <manifest> 元 素 中 ) 

€ android:versionName( 位 于 <manifest> 元 素 中 ) 

€ android:icon( 位 于 <applicationt> 元 素 中 ) 
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€ android:label( 位 于 <application> 元 素 中 ) 
android:label 属 性 指定 了 应 用 程序 的 名 称 。 这 个 名 称 将 显示 在 Android 设 备 的 Settings | 
Applications | Manage Application 部 分 中 。 对 于 LBS 项 目 ， 我 们 给 应 用 程序 起 名 为 Where Am I: 


<?xml version-"1.0" encoding-"utf-8"?»-» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.LBS" 
android:versionCode-"]" 
android:versionName-"1.0"- 
«application android:icon-"(drawable/icon" android:label-"Where Am I"- 
«uses-library android:name-"com.google.android.maps" /» 
«activity android:name-".MainActivity" 
android:label-"Q8string/app name"- 
<intent-filter> 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter-» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"7" /> 
«uses-permission android:name-"android.permission.INTERNET" /» 
«uses-permission android:name-"android.permission.ACCESS FINE LOCATION" /> 
«uses-permission android:name-"android.permission.ACCESS COARSE LOCATION" /> 


-/manifest» 


另外 ， 如 果 应 用 程序 需要 一 个 最 低 版 本 的 SDK， 那 么 可 以 在 AndroidManifest.xml 文 件 中 使 
用 <uses-sdk> 元 素来 指定 : 
<?xml version-"1.0" encoding-"utf-8"?- 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.LBS" 
android:versionCode-"]" 
android:versionName-"1.0"- 
«application android:icon-"((idrawable/icon" android:label-"Where Am I"> 


«uses-library android:name-"com.google.android.maps" /» 


«activity android:name-".MainActivity" 
android:label-"Qstring/app name"- 
«intent-tilter- 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter-» 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-2"7" /> 
«uses-permission android:name-"android.permission.INTERNET" /> 
«uses-permission android:name-"android.permission.ACCESS FINE LOCATION" /- 
«uses-permission android:name-"android.permission.ACCESS COARSE LOCATION" /» 


«/manifest» 
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在 前 面 的 示例 中 ， 应 用 程序 需要 的 最 低 SDK 版 本 为 7， 即 Android 2.1。 一 般 来 说 ， 将 这 个 版 
本 号 设置 为 应 用 程序 可 支持 的 最 低 版 本 是 明智 的 。 这 可 以 保证 有 更 广泛 的 用 户 可 以 运行 您 的 应 用 
程序 。 尽 管 在 写作 本 书 时 Android 的 最 新 版 本 是 2.3， 但 是 仍旧 有 大 量 设备 在 运行 Android 2.1 和 2.2。 


11.1.2. ”对 Android 应 用 程序 进行 数字 签名 


所 有 Android 应 用 程序 在 被 允许 部 垩 到 设备 (或 模拟 吉 ) 上 之 前 必须 经 过 数字 签名 。 与 一 些 手 
机 平台 不 同 ， 您 不 需要 从 认证 机 构 (CA) 购 买 数字 证 书 来 进行 签名 。 相 反 ， 您 可 以 生成 目 己 的 目 
签名 证 书 并 用 它 为 应 用 程序 签名 。 


将 目 动 为 您 对 其 进行 签名 。 可 以 在 Eclipse 中 选择 Window | Preferences， 展 开 Android 项 ， 选 择 
Build( 如 图 11-1 所 示 ) 来 验证 这 一 点 。Eclipse 使 用 一 个 默认 的 调试 密 钥 库 ( 被 命名 为 debug.keystore) 

如 果 您 正在 发 布 一 个 Android 记 用 程序 ， 就 必须 使 用 您 日 己 的 证 书 来 对 其 进行 签名 。 使 用 调 
试 证 书签 名 的 应 用 程序 是 不 能 被 发 布 的 。 虽然 您 可 以 使 用 Java SDK 提 供 的 keytoolexe 实 用 程序 来 
手动 生成 日 己 的 证 书 ， 但 Eclipse 通 过 提供 一 个 同 导 使 这 一 过 程 变 得 更 容易 了 ， 它 可 以 引导 您 一 
步 步 地 生成 证 书 。 它 将 使 用 生成 的 证 书 对 应 用 程序 进行 签名 (也 可 以 使 用 Java SDK 的 jarsigner.exe 
工具 进行 手动 签名 )。 

下 和 面 的 “ 试 一 试 ” 展 示 了 如 何 使 用 Eclipse 导 出 一 个 Android 应 用 程序 并 使 用 新 生成 的 证 书 进 
行 签 名 。 


type filter text Build 
» General | 


4 Android Build Settings: 


| [V] Automatically refresh Resources and Assets folder on build 
[V] Force error when external jars contain native libraries 
Build output 
|  ( Silent 
5 Normal 
© Verbose 


» Data Management E Default debug keystore — CAUsersWWei-Meng Lee.androidVdebug.keystore 
t Hel — —C—«NC- ""-"-EIrseC E 0 
E Custom debug keystore: 


p Java 


| b Java Persistence 
JavaScript 


, Plug-in Development ~ 


图 11-1 
导出 Android 应 用 程序 并 对 其 签名 
(1) 司 动 Eclipse， 打 开 在 第 9 章 创建 的 LBS 项 目 。 


(2) 在 Eclipse 中 选择 LBS 项 目 并 选择 File | Export.…。 
(3) 在 Export 对 话 框 中 ， 展 开 Android 项 ， 并 选择 Export Android Application( 如 图 11-2 所 示 )。 
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(4) 现在 LBS 项 目 应 该 显示 出 来 了 (如 图 11-3 所 示 )， 单 击 Next 按 钮 。 


| 图 | Export Android Application ^w 


Project Checks 


Performs a set of checksto make sure the application can be exported. 


Select an export destination: Select the project to export: 
Project: LBS 


b E General No errors found. Click Mext. 
a [2 Android 


[| 
p [m EB 
b E lava 
t E lawa EE 
b [£z Plug-in Development 
t EE Remete Systems 
5 E Run/Dehbug 
b EE Tasks 
b EE Team 
b [25 Web 
b [29 Web Services 
b E XML 


11-2 图 11-3 

(5) 选择 Create new keystore 选 项 来 创建 一 个 新 的 证 书 ( 密 钥 库 ) 用 于 应 用 程序 签名 (如 图 11-4 记 
示 )。 输 入 保存 新 密 钥 库 的 路 径 并 输入 一 个 密码 来 保护 此 密 钥 库 。 在 本 例 中 ， 输 入 password 作 为 
密码 ， 单 击 Next 按 钮 。 

(6) 为 私 钥 提供 一 个 别名 (命名 为 DistributionKeyStoreAlias， 如 图 11-5 所 示 ) 并 输入 一 
个 密码 来 保护 私 钥 。 在 本 例 中 ， 输 入 password 作 为 密码 。 还 需要 输入 密 钥 的 有 效 期 。 根 据 
Google 的 规定 ， 您 的 应 用 程序 必须 用 一 个 加 密 的 私 钥 进 行 签名 ， 其 有 效 期 要 到 2033 年 10 月 
22 日 以 后 才能 结束 。 因 此 ， 应 该 输入 一 个 大 于 2033 减 去 当前 年 份 的 数 。 单 击 Next 按 钮 。 


FED ExportAndreid Application 


(E) Export Android Application — 


Keystore selection Kev Creation 


(^) Use existing keystore 
@ Create new keystore 
Location: |. CAUsers Wei-Meng Lee DesktopsDistributionkKeyStore 
Validity (years): 


First and Last Name: Wei-Meng Lee 


| Organizational Unit; 


Organization: 
| City or Locality: 


State or Province 


| Country Code (XX): 
1 


图 11-4 图 11-5 
(7) 输入 存储 APK 目 标 文 件 的 路 径 ( 如 图 11-6 所 示 )。 单 击 Finish 按 钮 ， 将 生成 APK 文 件 。 
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fl Export Android Application 
|| Destination and kev/cartificate checks 


|| Destination APK file: C Users Wei-Meng Lee\ Desktopi LBS.apk 


| Certificate expires in 30 years. 


图 11-6 
(8) 在 第 9 章 中 ，LBS 应 用 程序 需要 使 用 Google Maps API 密 钥 。 这 个 密 钥 是 通过 使 用 您 的 
debug.keystore 的 MD5 指 纹 申 请 到 的 。 这 意味 者 Google Maps API 密 钥 与 用 来 对 应 用 程序 进行 签 
名 的 debug.keystore 是 捆绑 在 一 起 的 。 因 为 您 现在 生成 了 ai 签名 和 部 
团 ， 所 以 需要 使 用 新 密 钥 库 的 MD5 指 纹 再 次 申请 Gooegle Maps API 密 钥 。 要 做 到 这 一 点 ， 在 命令 
提示 符 窗 口中 输入 以 下 命令 (keytool.exe 实 用 程序 的 位 置 可 能 略微 不 同 ， 需 要 使 用 在 前 和 面 第 (5) 步 
所 选择 的 路 任 来 苦 换 这 个 密 钥 库 的 路 符 ， 如 图 11-7 所 示 ): 


| ca = 


ES C^Windows'system32Wcmd,.exe 


G: sSProgram Files^Java*Xjre6*«bin?»kevytool.exe -list -alias DastributionkKeyStorehlilia 


S keystore "GCG: sers™ lei-Meng Lee*>Desktop*>Distribut ionKeyStore" -storepass pass 
word -keypass password 


Distr "ibut ionkeyïtorelias. Dec 26. 2818. PrivateKeyEntry. E 
| 
Certificate fingerprint (MDS): EA:5B:3C:F2:B5:78:16:2D:2E:DC:36:59:88:14:B4:11 


:Program Files^Java*Xjre6 «bin», 


图 11-7 


C:\Program FilesMJavaNMjre6XMbin»keytool.exe -list -alias 
DistributionKeyStoreAlias -keystore "C:\Users\Wei-Meng Lee\Desktop\ 


DistributionKeyStore" -storepass password -keypas spassword 


(9) 使 用 从 前 面 的 步骤 获得 的 MD5 指 纹 ， 转 划 http: /code.google.comyandroid/add-ons/google- 
apis/maps-api-signup.html 并 签署 一 个 新 "va API 密 钥 。 
(10) 在 main.xml 文 件 中 输入 新 的 Maps API?Z £3: 


«?xml version-"1.0" encoding-"utf-8"?-» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 


«com.google.android.maps.MapView 
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android:id-"Q-cid/mapView" 
android:layout width-"ftill parent" 
android:layout height-"fill parent" 
android:enabled-"true" 
android:clickable-"true" 
android:apiKey-"«Your Key Here»" /> 


«/LinearLayout» NM 
TE) Export Android Application 


(11) 由 于 在 main.xml 文 件 中 输入 了 新 的 Maps || etm 
API 密 钥 ， 现 在 需要 您 再 一 次 导出 应 用 程序 并 重 “ 站 二 一 一 一 
密 钥 库 时 ， 选 择 Use existing keystore 选 项 (如 图 11-8 
所 示 ) 并 输入 一 个 先前 用 十 保护 您 的 密 钥 库 的 密码 
(在 这 里 ， 密 但 是 password)。 单 击 Next 按 钮 。 

(12) 选择 Use existing key m (A E] 11-9 
示 ) 并 输入 先前 设置 的 用 于 保护 私 钥 的 密码 (输入 
password)。 单 击 Next 按 钮 。 

(13) 单 击 Finish 按 钮 (如 图 11-10 所 示 ) 再 次 生 
成 APK 文 件 。 

到 此 为 止 ，APK 已 经 生成 了 ， 它 包含 了 捆绑 
到 痢 密 钥 库 的 新 的 Maps API 密 钥 。 


图 11-8 


T Export Android Application B= X 7 T Export Android Application 


Key alias selection P. Destination and key/certificate checks 
di Destination file already exists. 


® Use existing key Destination APK file; CAUsersWei-Meng LeeDesktopLBS.apk 
Alias: distributionkeystorealias 
Certificate expires on Tue Dec 18 00:11:48 SGT 2040. 


+ WARNING: destination file already exists 


Password: s»sasesas | 


(^) Create new key 


[T 


图 11-9 图 11-10 
示例 说 明 


Eclipse 提供 了 Export Android Application 选 项 ， 可 以 帮助 您 将 Android 应 用 程序 导出 为 一 个 
APK 文 件 并 生成 一 个 用 于 对 APK 文 件 进行 签名 的 新 的 密 钥 库 。 对 于 使 用 Maps API 的 应 用 程序 ， 
要 注意 Maps API 必 须 和 为 您 的 APK 文 件 签名 的 新 密 钥 库 相 关联 。 
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11.2 部署 APK 文 件 


一 旦 对 APK 文 件 进行 了 签名 ， 就 需要 有 个 方法 将 它们 转移 到 用 户 设备 上 上。 下面 的 小 节 将 摘 
述 部 团 APK 文 件 的 不 同方 法 ， 主 要 包括 以 下 3 个 方法 : 
多 ”使 用 adb.exe 工具 手动 部 署 
e 在 Web 服 务 器 上 托管 应 用 程序 
e i Android Market ff 
除了 以 上 方法 ， 还 可 以 通过 电子 邮件 、SD 卡 等 方式 将 您 的 应 用 程序 安装 到 用 户 设备 上 。 只 
要 能 将 APK 文 件 转移 到 用 户 设备 上， 您 就 能 够 安装 这 些 应 用 程序 。 


11.2.1 使 用 adb.exe 工 具 
一 旦 Android 应 用 程序 经 过 签名 ， 束 可 以 使 用 abd.exe(Android Debug Bridge) 工 具 ( 位 于 
Android SDKIl'Jplatform-tools X 件 夹 中 ) 将 其 部 署 到 模拟 器 和 设备 上 。 
使 用 Windows 中 的 命令 提示 符 ， 转 到 <Android_SDK>\platform-tools 文 件 夹 下 。 
设备 上 安装 应 用 程序 (假设 模拟 器 当前 已 经 启动 并 运行 或 设备 已 连接 )， 可 输入 以 下 命令 


adb install "C:\Users\Wei-Meng LeeMDesktopMLBS.apk" 
adb.exe T RAT 28 


adb.exe 工 具 是 一 个 多 功能 的 工具 , 可 以 用 来 控制 与 您 的 计算 机 相连 的 Android 设 备 ( 和 模 
拟 器 )。 
默认 情况 下 , 当 使 用 adb 命 令 时 , 假定 当前 只 连接 了 一 台 设 备 /模拟 器 。 如 果 连 接 了 多 台 设 
备 , 那么 adb 命 令 会 返回 一 个 错误 消息 : 
error: more than one device and emulator 
可 以 使 用 adb 的 device 选 项 来 查看 当前 连接 到 计算 机 上 的 设备 , 如 下 所 示 : 


D:MAndroid 2.3\android-sdk-windows\platform-tools>adb devices 


List of devices attached 
HTO 7YPYO09335 device 
emulator-5554 device 
cemulator-5555 device 


正如 上 面 的 示例 所 显示 的 , 这 个 命令 返回 一 个 当前 已 连接 设备 的 列表 。 为 了 给 一 个 特定 
的 设备 发 出 命令 , 需要 使 用 -s 选 项 来 指明 此 设备 , 如 下 所 示 : 
adb -s emulator-5556 install LBS.apk 
如 果 试 图 在 一 台 已 有 APK 文 件 的 设备 上 安装 该 文件 , 将 显示 以 下 错误 消息 : 
Failure [INSTALL FAILED ALREADY EXISTS] 
图 11-11 展 示 了 在 一 台 真实 设备 上 成 功 安装 了 一 个 APK 文 件 。 


ER COWIndowsisystem32'cmd exe 


D: “fndroid 2.3 '«androeid-zdk-wuindows*splatform-toolzs*adbhb —s HTH7VPVBH2335 install "C 
IzizerzMdei-Meng Lee-Desktop-LBS.apk'" 
b71 KBs (18573 bytes in BH.H27z? 

pkg: ^/"datazÁ/local/^tnpAÁLB5 .apk 


Success 
| 


11-11 
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如 果 查 看 Android 设 备 /模拟 器 上 的 Launcher， 可 以 看 到 LBS 图 标 ( 在 图 11-12 的 左 侧 )。 如 果 在 
Android 设 备 /模拟 器 上 选择 Settings | Applications | Manage Applications， 将 可 以 看 到 Where Am I 
应 用 程序 (在 图 11-12 的 右 侧 )。 

z a d 5:31 


Browser Calculator Camera Clock 


B 


Custom DevTools Downloads 
Locale 


UE È 5:32 


à Id - 区 
| - | 
Downloaded On SD card Running 


TTS Service 
0.00B 


User Dictionary 


20.00KB 


VPN Services 
0.00B 


Bag 
Files 


Gallery latitude 


Where Am I 


30.00KB 


谷歌 拼音 输入 法 


0.DO0B 


f 30MB used i 34MB free 


图 11-12 
adb.exe 工 具 除 了 可 以 用 来 安装 应 用 程序 ， 还 可 以 用 来 移 除 应 用 程序 。 要 做 到 这 一 点 ， 可 以 
使 用 shell 选 项 将 一 个 应 用 程 订 从 其 安装 文件 来 下 移 除 : 
adb shell rm /data/app/net.learn2develop.LBS.apk 
部 四 应 用 程序 的 男 外 一 种 方法 是 使 用 Eclipse 中 的 DDMS 工 具 ( 如 图 11-13 所 示 )。 选 择 一 个 模 
拟 右 (或 设备 ) 后 ， 使 用 DDMS 中 的 File Explorer 进 入 到 /data/app 文 件 夹 并 通过 Push a file onto the 
device 按 钮 将 APK 文 件 复制 到 设备 上 。 


a DDMS - LBE/Andreid Manifest xml - Eclipse 


| File Edit Run Navigate Search Project Refactor Window Help 
PE Ead :W-:4- ES $S Debug [m DOMS |ë} lava 99 lava EE 
W e c e E d F o 
E Devices 1^ ~ =a E: Threads | @ Heap | Allocation Tracker [i File Explorer. 23 >, 
3| d me | *?|$9|N " Name Size Date 
Name 4 [7 data 2010-12-25 
EJ emulatar-5554 p & anr 2010-12-25 1 


system process 4 [5 app | | 2010-12-25 

com.android.phone & LBS.apk 18506 2010-12-25 

com.android.inputmethod latin ) [Ew app-private 2010-12-25 1456 d 

b [E backup 2010-12-25 14 

; [EE dalvik-cache 2010-12-25 
2010-12-25 


com.andraid.launcher 
com.andraid.systemui 
com.google.prncess.gapps ur 
net.learn? develop.LBS 2010-12-25 
Cu E ERN, ZU10-12-25 


图 11-13 


11.2.2 使 用 Web 服 务 器 
如 果 希 望 自己 驻 留 应 用 程序 ， 可 以 使 用 一 台 Web 服 务 回来 完成 。 如 果 您 有 自己 的 Web 托 管 服 
务 并 且 打算 为 您 的 用 户 免费 提供 应 用 程序 (或 者 将 访问 限制 为 特定 用 户 群 )， 这 是 个 不 错 的 选择 。 


qf) ER: 在 下 载 了 APK 文 件 后 ， 即 使 您 将 对 应 用 程序 的 访问 限制 为 某 个 特定 的 
T 用 户 群 ， 也 还 是 没有 什么 能 阻止 这 些 用 户 将 您 的 应 用 程序 重新 分 发 给 其 他 用 户 。 
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为 了 说 明 这 一 点 ， 我 将 使 用 我 的 Windows 7 计算 机 上 的 ISGnternet Information Server)， 将 已 签 
名 的 LBS.apk 文 件 复制 到 cinetpubvwwwroot。 另 外 ， 创 建 一 个 新 的 名 为 Install.html 的 HIML 文 


<html> 

<title>Where Am I application</title> 

<body> 

Download the Where Am I application «a href="LBS.apk">here</a> 
«/body» 

«/html» 


注意 : 如 果 不 清楚 如 何在 Windows 7 计算 机 上 设置 IIS， 可 查阅 以 下 链接 ; 


http:/technet.microsoft.comyen-us/library/cc723702.aspX。 


在 您 的 Web 服 务 嚣 上， 需要 为 APK 文 件 注册 一 个 新 的 MIME 类 型 。.apk 扩 展 名 对 应 的 MIME 


类 型 是 application/vnd.android.package-archive。 


d 注意 : 要 在 Web 上 安装 APK 文 件 ， 需 要 在 您 的 模拟 器 或 设备 上 安装 一 个 SD 
” 卡 。 这 是 由 于 下 载 的 APK 文 件 将 保存 在 SD 卡 的 download 文 件 志 下 。 


默认 情况 下 ， 对 于 在 线 安 装 Android 应 用 程序 ，Android 模 拟 器 或 设备 只 允许 安装 来 目 
Android Market(www.android.com/market) 的 应 用 程序 。 因 此 ， 对 于 在 Web 服 务 器 上 的 安装 ， 需 
要 配置 您 的 Android 模 拟 器 /设备 以 接受 来 日 非 Android Market 源 的 应 用 程序 。 

在 Application settings% F, X Unknown sources 项 (如 图 11-14 所 示 )， 会 出 现 一 个 警告 消 
息 ， 单 击 OK 按 钮 。 选 中 这 一 项 将 允许 模拟 器 /设备 可 以 安装 来 自 非 Android Market 源 的 应 用 程序 
(例如 来 日 一 人 台 Web 服 务 嚣 )。 


站 andrad_ 2.3 Emulator WithsD 4 555A ndraid 2.3 Emulatar WithsD 


Application settings 


Unknown sources — Unknown sources 


Allow installation of non-Market 
applications 


A Attention 
Quick launch 
Set keyboard shortcuts to launch applications Your phone and personal data 

NECADCHIDQAM GI RE cM NE QUU Mp TEES are more vulnerable to attack 

Manage applications by applications from unknown 


Manage and remove installed applications sources. You agree that you 
一 一 一 一 一 一 一 一 一 一 一 一 are solely responsible for any 


Runni ng services damage to your phone or loss 
of data that may result from 


using these applications. 


View and control currently running services 


Storage use 
View storage used by applications — 
pe ra DN AC EE s Lance 


Battery use 


Davalan mont 


图 11-14 
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为 了 从 运行 在 您 计算 机 上 的 IIS Web 服 务 器 安装 LBS.apk 应 用 程序 ， 可 在 Android 模 拟 器 /设备 
上 启动 Browser 应 用 程序 ， 并 导航 到 指 同 APK 文 件 的 URL。 为 了 指 癌 运行 模拟 右 的 计算 机 ， 应 该 
使 用 特殊 的 下 地 址 : 10.0.2.2。 或 者 ， 也 可 以 使 用 主机 的 下 地 址 。 图 11-15 展 示 了 了 Web 浏览 费 上 加 
载 的 Install.html 文 件 。 单 击 here 链 接 将 会 把 APK 文 件 下 载 到 您 的 设备 上 。 加 下 拖 动 通知 栏 可 以 显 
示 下 载 的 状态 。 


& . 5554; Àndraid 2.3 Emulator WithSD | ao 5554 AÀndraid 2.3 Emulator Withs D 


| December 26, 2010 基 wl È 201 


- - - | 

| |http://10.0.2.2/Install.ht... | Clear | 
TM | Notifications 

Download the Where Am I application | 


here | LBS.apk 


图 11-15 
为 了 安装 下 载 的 应 用 程序 ， 只 要 轻 轻 地 单 击 应 用 程序 ， 将 显示 出 该 应 用 程序 所 需要 的 权限 
(如 图 11-16 所 示 )。 


& 53554 AÀndroid 2.3 Emulator. WithsD 


Do you want to install this 
application? 


Allow this application to: 


Your location 


coarse (network-based) location, fine 
(GPS) location 


Network communication 
full Internet access 


Install Cancel 
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单 击 Install 按 钮 继续 安装 。 当 应 用 程序 安装 完毕 ， 可 以 单 击 Open 按 钮 来 月 动 它 (如 图 11-17 
PEFR) o 


& S5554:Android 2.3 Emulator WithSD 


0000 


o (0 


0000 


Application installed 


a f2 |a fa [s [e | ls |o lo 
a w fe |r |r y fu |r jo |e 
a |s |o [e [e fu |j |k fe [& 
Mez jx ic lv ls inm]. je 
Limo 


除了 使 用 Web 服 务 器 ， 还 可 以 用 电子 邮件 将 应 用 程序 作为 附件 发 给 用 户 。 当 用 己 收 到 邮件 
时 ， 他 们 可 以 下 载 附 件 并 在 目 己 的 设备 上 直接 安 蔷 。 


11.2.3 在 Android Market 上 发 布 


到 目前 为 止 ， 您 已 经 学 习 了 如 何 打包 Android 应 用 程序 以 及 分 发 应 用 程序 所 能 使 用 的 多 种 方 
法 一 一 通过 Web 服 务 器 、adb.exe 文 件 、 电 子 邮 件 、SD 卡 等 。 

然而 ， 这 些 方法 不 能 为 用 户 提供 一 个 可 以 很 容易 地 发 现 您 的 应 用 程序 的 途径 。 更 好 的 方法 
是 由 Android Market 托 管 您 的 应 用 程序 ， 这 是 一 个 可 以 使 用 户 为 其 Android 设 备 发 现 和 下 载 (购买 ) 
应 用 程序 变 得 非常 容易 的 由 Google 托 省 的 服务 。 用 户 只 需要 在 他 们 的 Android 设 备 上 启动 Market 
应 用 程序 ， 就 能 够 发 现 可 以 在 他 们 设备 上 进行 安装 的 各 种 应 用 程序 。 

在 本 节 中 ， 将 学 习 到 如 何在 Android Market 上 发 布 Android 应 用 程序 。 我 将 一 步 步 地 引导 您 
完成 友 布 ， 包 括 在 提交 给 Android Market 剖 应 用 程序 所 需要 做 的 各 项 准备 。 

1. 创建 一 个 开发 者 简介 

ft Android Market 上 发 布 应 用 程序 的 第 一 步 是 在 http://market.android.com/publish/Home 上 创 
建 一 个 开发 者 侧 介 。 这 需要 一 个 Google 账 尸 (例如 您 的 Gmail 账户 )。 一 旦 登录 进 Android Market, 
首先 创建 开发 者 简介 (如 图 11-18 所 示 )。 在 输入 所 要 求 的 信息 后 单 击 Continue。 

为 了 在 Android Market 上 发 布 应 用 程序 ， 需 要 文 付 一 次 性 的 注册 费用 ， 目 前 是 25 美 元 。 单 击 
Google Checkout 按 钮 (如 图 11-19 所 示 ) 备 定 问 到 一 个 可 以 支付 注册 费用 的 页 面 。 付 费 之 后 ， 蛙 击 
Continue ftt% , 


340 


第 11 章 ”发布 Android 应 用 程序 


rr Developer Signup We 


€ C |o market.android.com/publish/signup * a 


$3 market 


| Getting Started 


Ael 


weimenglee(?gmail.com | Home | Help | Android com | Sign out 


Before you can publish software on the Android Market, you must do three things: 
è Create a developer profile 


+ Pay a registation fee (525.00) with your credit card (using Gopgle Checkout) 
+ Agree to the Android Market Developer Distribution Agreemen 


Listing Details 


Your developer profile will determine how you appear to customers inthe Android Market 


Developer Name Developer Leaming Solutic 
Will appear to users under the name of your application 


Email Address 
Website URL 


Phone Number 
Include plus sign, country code and area code. For example, «1-550-253-0000. why do we ask for this? 


Email Updates Contact me occasionally about development and Market opportunities. 


Continue » 


© 2010 Google - Android Market Developer Distribution Ag | oogle Terms of Semice - Privacy Policy 


- mer" X 


f Developer Signup 


é > C [e marketandroid.com/publish/signup Ld ` 


» market 


Register as a developer 


am. 


weimenglee(dgmail.com | Home | Help | Android.com | Sign out 


Registration fee: $25.00 


Y pur registration fee enables you to publish software in the market. The name and billing address used to register will bind you to the Android Market 
Developer Distribution Agreement. Sa make sure you double check! 


Pay your registration fee with 


(Google EE: ut .»- 


Fast checknut through Google 


Continue » 


© 2010 Google - Android Market Developer Distribution Agreement - Google Terms of Senice - Privacy Poli 


图 11-19 


接 下 来 ， 需 要 同意 Android Market Developer Distribution Agreement. FI agree 复 选 框 并 单 
击 Iagree. Continue 链 接 ( 如 图 11-20 所 示 )。 
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- Developer Signup. 


e — QU D market.android.com/publish/signup MM | EE JE 


weimengleeggmail.com | Homes | | Andrnid.com | Sign nut E 
a On2a200 glee&g Help | Andraid.com | Sign out 


| 3 market 


Read and agree to the Android Market Developer Distribution Agreement 


CcIn25301»5 


Android Market Developer Distribution Agreement 

Definitions 

Google: Gopgle Inc., a Delaware conaratian with principal place af business at 1600 Amphitheatre Parkway, 
Mountain View, CA 44043, United Statea. 


Ferson registered to this account: 
| Lee Wei Mang 


| agree and | am willing to associate my credit card and account registration above with the Android Market 
Developer Distribution Agreement. 


Lagree, Continue » Cancel this Registration 
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2. 提交 应 用 程序 

一 旦 设置 好 简介 后 ， 就 要 准备 辣 Android Market 提 交 应 用 程序 了 。 如 果 您 的 应 用 程序 打算 收费 ， 
单 击 位 于 屏 大 底部 的 Setup Merchant Account 链 接 。 在 这 里 输入 诸如 银行 账号 、 税 与 等 秆 外 信息 。 

对 于 免费 的 应 用 程序 ， 单 击 Upload Application 链 接 ， 如 图 11-21 上 所 示 。 


iis Developer Console x Want | 
di E 


weimengleegkmail.com | Home | Help | Android.cam | Sign aut = 
On33el2 " à " 


3 market 


Your Registration to the Android Market is approved! 
You can now upload and publish sofware to the Android Market. 


Developer Learning Solutions 
w aimengleeig pmail com 
Edt profile + 


All Android Market listings 


No applications uptaaded 


Development phones 

As a registered developer, you can purchase an unlocked 
phane. 

Buy now » 


Google checkout 至 


Want to sell applications in the Android Market? 


Set up a Merchant account with Google Checkout! You will 
need to enter additional infarmatian like your bank account 
information and Tax IO- 

Setup Merchant Account s 


11-21 
这 时 ， 将 会 要 求 您 输入 关于 应 用 程序 的 一 些 详细 信息 。 图 11-22 展 示 了 需要 您 提供 的 第 一 组 
详细 信息 。 在 所 需 的 信息 中 ， 必 须 提供 的 包括 : 
€ APK 格 式 的 应 用 程序 。 
e ”至少 两 个 屏幕 快照 。 可 以 使 用 Eclipse 中 的 DDMS 透 视图 来 捕获 应 用 程序 在 模拟 器 或 真实 设备 
上 运行 时 的 快照 。 
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e 一 个 高 分 辩 率 的 应 用 程序 图 标 。 图 像 大 小 必须 是 512X512 像 素 。 
其 他 详细 信息 是 可 选 的 ， 可 以 以 后 再 提供 。 


ijs Developer Console 


€ — Q 0 marketandroid.com/publish/HomesEDIT APPLICATION Tq 


Da 
wweimaenglesglgmail.com | Home | Help | Android.com | Sign out 3 
a N2301 giooBig : | 


- market 


Your Registration to the Android Market is approved! 
You can now uplaad and publish software to the Android Market. 


Upload an Application 


Upload assets 


Draft application .apk file 
click the ‘publiski button 
to publish draft apk file 


Screenahots 
at least z 


High Resolution Application 
Icon 
[Learn More] 


Promotional Graphic 
optional 


Feature Graphic 
optional 


Promotional Video 
optional 


Marketing Opt-Out 


Upload an apk file- 
Mo file chosan 


Add a sereenshat 


Ma file chosan 


Add a hi-res apglicatian icon: 


Ma file chosen 


Add a promatianal graphic 


Ho file chosen 


Add a feature graphic: 


Ha file chosan 


Add a promatianal vidaa link: 
http; 


Screenahaota: 

320w x ABOh, 480 x S00h, 

ar A8 x &54h 

234 bit PNG ar JPEG (na alpha) 
Full haed. na bordar in ari 
Landscape thumbnails are cropped 


High Resolution Application Icon: 
B512w x 5T2h 

34 bit PHG ar JPEG (na alpha) 
Maximum: 1024 KB 


Promo Graphic: 

180w x 12üh 

24 bit PHG ar JPEG (na alpha) 
Full haed, na bordar in ari 


Feature Graphic: 

1024 x S00h 

24 bit PHG or JPEG (na alpha] 
Will be dewnzized to mini ar micra 


Promotional Vidao: 
Enter YouTube URL 


发 布 Android 应 用 程序 


E Dn nat promote my application except in Android Market and in any Gaoglg-awned online or mobile 
properties. | understand that any changes to this preferenze may take sixty days to take affect. 


图 11-22 


图 11-23 展 示 了 我 已 占 Android Market 站 点 上 传 了 LBS.apk 文 件 。 特 别 要 注意 ， 基 于 您 上 传 的 
APK 文 件 ， 将 会 有 和 警 各 消息 ， 告 诉 用 户 所 需 的 特定 的 权限 ， 您 的 应 用 程序 的 功能 将 被 用 来 作为 
搜索 结果 的 师 选 条 件 。 例 如 ， 由 寸 我 的 应 用 程序 要 求 接 入 GPS， 对 于 那些 没有 GPS 接 收 禹 的 设备 
的 用 户 ， 我 的 应 用 程序 殊 不 会 在 他 们 的 搜索 结果 列表 上 显示 。 


D. Developer Console 


é — QC |0 marketandroid.com/publish/HomesFDIT APPLICATION?pkg-net.leamzdevelop.L B5 


Upload assets 


Drafi application .apk file 
click the ‘publish’ button 
to publish draft apk fila 


Screenshots 
at least 2 


add another 


High Resolution Application 
Icon 
[Learn Mare] 


net learnZdeselng LES (18k) KJ Saved Draft 


Where Am | 
[a YersionMame: 1.0 
VaersionCoda: 1 


Localized to- default 


国 This apk requeat 3 permissions that users will be warned about 
andraid.permissian.IHTERHET 
andraid.permissinn ACCESS FIME LOCATION 
andraid.penmissiaon ACCESS. COARSE LOCATION 


BThis apk requests 4 features that will be used for Android Market filtering 
andraid.hardwara.Incatian.netwark 
android. hardware location 
android.hardwares-location.gps 
android. hardwara.iauchscresn 


Screenshots: 

32h x 480h, A80) x Ah, 

ar dw x B54h 

到 bit PNG or JPEG (no alpha] 
Full bleed, na border in art 
Landscape thumbnails are crapped 


High Resolution Application Icon: 
Tzw x 512h 

24. bit PNG ar JPEG (no alpha) 
Maximum: 1024 KE 


11-23 


343 


Android 编 程 入 门 经 典 


需要 提供 的 下 一 组 信息 如 图 11-24 所 示 ， 包 含 了 应 用 程序 的 标题 、 其 描述 以 及 最 新 修改 的 细 
(对 于 应 用 程序 更 新 很 有 用 )。 还 可 以 选择 应 用 程序 的 类 型 和 在 Android Market 中 所 属 的 类 别 。 


- Developer Console x Wb 


€ > Q (D marketandroid.com/publish/HomesEDIT APPLICATION 


Listing details 


Language |*English fen} | 
add language Star sign ("] indicates the default language. 


Tide (an) [Where Am | 
1D characters (30 max) 


Description (an) Ihis application allmnwgós you LD view visually where you are 


locarced using rhe Google Mapa on your Android device. You can 
also know the addressa of a location on the map hy simply 
touching on it. 


Ihis application is a demo-applicarinn for rhe upcoming book 一 
Beginning Android Application Development |Wrox} by Wei-Meng 
Lez. 


324 characters (4000 max) 
Recent Changes fan) 


WYersionName: 1.0 


[Learn Wore] 


Ihis is the firat vereion of thia application. 


AB characters (500 max) 


Promo Text [en) | 
E 


Ü characters (BD max) 
Application Type Applications 


Category | Lifestyle [-] 


Price Free Want to sell applications? Setup a Merchant Account at Googe Checkout 
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在 最 后 一 个 对 话 框 中 ， 可 以 指明 您 的 应 用 程序 是 否 及 用 版 权 保护 以 及 指定 内 容 等 级 。 还 可 
以 提供 您 的 网 站 的 URL 以 及 您 的 联系 信息 (如 图 11-25 所 示 )。 


CC ma rketandroid.corn/publish/HomesEDIT APPLICATION 


Publishing options 


Copy Protaction i OT (Application can ba copied from the davice) 
A On (Helps prevent copying of this application tom the device. Increases the amount of 
memory on the phone required ta install the application.) 
The copy protection feature will be deprecated soon, please use licensing service instead. 


Content Rating i Mature 
[Learn Mare] 6 Teen 
i» Pre-Teen 
All This maing aptian nas bean dizaibled by tha Android Martat earn 


&alect locations to list in: 


[7] All locations 

(Includes mora countries than those listed below. As the developer, you are responsible far complying 
with: cauntry-specific laws related to the distribution or sale of your application inia that country, 
including your home country.) 


Contact information 
Website | http rwvww learnz2develop net 
Email 


imenglee qmail carm 


Phone 


Consent 


[V] This application meets Android Content Guidelines 


| acknowledge that my software application may be subject to United States export laws, regardless of my location ar nationality. | agree that | 
have complied with all such laws, including any requirements Tar sofware with encryption Tunctions. | hereby certif that my application is authorized 
for export fram the United States under these laws. [Learn More] 


Publish Save Delete 


图 11-25 
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当 同 意 了 册 个 准则 和 协议 后 ， 单 击 Publish 按 钮 将 您 的 应 用 程 厅 发 布 他 Android Market E. 
到 此 为 止 ， 您 的 应 用 程序 在 Android Market 上 就 可 用 了 。 您 将 能 够 查看 任何 已 提交 的 关于 您 
的 应 用 程序 的 评论 (如 图 11-26 所 示 ) 以 及 错误 报告 和 总 的 下 载 次 数 。 


ENT 


i A Developer Console 
$ Q |© marketandroid.com/publish/Home£LISTING CONSOLE * A 


| weimenglee(mgmail.com | Home | Help | &ndroid.com | Sign out [73 
| ~  0n2a3015 | 


| ey market 


Developer Learning Solutions 
wieimen glezidigmad.corm 
| Fui profile » 


| All Android Market listings 
| | F7* Wnero Am|vi.O (Orr rry 


I 0 total Errore Ww Published 
E Applicatians: Lifestyle Comments 0 active installs (0565) 


a Upload Application 


Development phones 

点 5 a registered developer, you can purchase an unlocked 
phone. 

Buy now » 


Google checkout PE 


Want to sell applications in the Android Market? 
Set up a Merchant account with Google Checkaut! You will 
need to enter additional information like your bank account 
information and Tax ID. 

| Setup Merchant Account » 


D 2010 Gnagle - Android Market Developer Distribution Agreement - Googe Terms af Service - Privacy Policy 


图 11-26 
视 您 好 运 ! 现在 ， 您 只 要 等 好 消 胃 就 行 了 。 希 望 很 快 您 就 能 一 路 笑 看 去 银行 ! 


11.3 ”本草 小 结 


在 本 章 中 ， 我 们 学 习 了 如 何 将 Android 应 用 程序 导出 为 一 个 APK 文 件 并 使 用 自己 创建 的 一 个 
密 钥 库 对 其 进行 数字 签名 。 然 后 ， 学 习 了 分 发 应 用 程序 的 多 种 方法 以 及 每 一 种 方法 的 优点 。 最 
后 ， 我 们 亲自 体验 了 在 Android Market 上 发 布 应 用 程序 所 需 的 步 又， 这 将 使 您 可 以 出 售 您 的 应 用 
程序 ， 并 且 带 来 更 多 的 用 户 。 和 希望 这 样 可 以 使 您 卖 出 更 多 的 产品 并 因此 获得 不 错 的 收益 ! 


1. 如何 指定 应 用 程序 所 需 的 Android 最 低 版 本 ? 
2. ”如 何 生 成 一 个 目 签名 证 书 来 为 Android 应 用 程序 签名 ? 
3. ”如 何 配 置 Android 设 备 ， 使 其 可 以 接收 非 Anroid Market 源 的 应 用 程序 ? 


练习 答案 参见 附录 CC。 
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本 章 主 要 内 容 
主 题 


用 于 发 布 应 用 程序 的 检查 表 


导出 一 个 应 用 程序 并 对 其 签名 


部 署 APK 文 件 


在 Android Market 上 发 布 应 用 


关键 概念 


要 在 Android Market 上 发 布 一 个 应 用 程序 ， 该 应 用 程序 必须 在 Android- 
Manifest.xml 文 件 中 具有 以 下 4 个 属性 : android:versionCode, 
android:versionName、android:icon 和 android:label 


要 分 发 的 所 有 应 用 程序 必须 使 用 一 个 目 签 名 证 书 进行 签名 。 调 试 密 钥 库 
对 于 分 发 来 说 是 无 效 的 


使 用 Eclipse 的 Export 功 能 将 应 用 程序 导出 为 一 个 APK 文 件 并 使 用 一 个 日 签 
名 证 书 对 其 签名 


可 以 使 用 各 种 方式 部 获 : Web 服 务 器 、 电 子 邮 件 、adb.exe 和 DDMS 等 


花费 25 美 元 向 Android Market 进 行 申请 ， 这 样 就 可 以 在 Android Market 上 
托管 和 出 售 应 用 程序 


使 用 Eclipse 进行 Android 开 发 


尽管 Google 支 持 使 用 诸如 IntelliJ 这 样 的 IDE 或 者 像 Emacs 这 样 的 基本 编辑 器 来 进行 AndroidJv 
用 程序 的 开发 ， 但 它 还 是 推荐 将 Eclipse IDE 和 ADT 插 件 一 起 使 用 。 这 样 做 可 以 使 开发 Android 应 
用 程序 变 得 更 容易 也 更 高 效 。 本 附录 描述 了 Eclipse 中 可 用 的 一 些 可 以 使 您 的 开发 工作 变 得 更 加 
容易 的 极 好 功能 。 


注意 : 如 果 您 还 没有 下 载 Eclipse， 那 么 可 以 从 第 1 章 开 始 学 起 。 在 那里 ， 
您 将 学 到 如 何 获取 Eclipse 以 及 对 它 进行 配置 ,使 其 可 以 和 Android SDK 一 起 使 
用 。 本 附录 假定 您 已 经 为 Android 开 发 设置 好 了 Eclipse 环 境 。 


A.1 “Eclipse 概览 


Eclipse 是 一 个 高 度 可 扩展 的 多 语言 软件 开发 环境 ， 可 以 文 持 各 种 应 用 程序 开发 。 使 用 
Eclipse， 可 以 利用 多 种 语 吝 来 编写 和 测试 应 用 程序 ， 例 如 Java、C、C++、PHP、Ruby 等 。 由 于 
其 可 扩展 性 ，Eclipse 的 新 手 弟弟 感到 对 其 IDE 无 所 适 从 。 因 此 ， 以 下 小 区 的 内 容 旨 在 帮助 您 在 
Android 旋 用 程序 的 开发 过 程 中 可 以 更 加 熟练 地 使 用 Eclipse。 


A.1.1 工作 区 


Eclipse 采用 工作 区 [X (workspace) 的 概念 exo BIB LEK Ld TA PT 
AR: 
当 第 一 次 启动 Eclipse 时 ， 将 提示 您 选择 一 个 工作 区 (如 图 A-1 所 示 )。 


择 的 用 来 保存 所 有 项 目的 一 


ui Workspace Launcher 


Select a workspace 


Eclipse stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


[E] Use this az the default and do not ac 


图 A-1 
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当 Eclipse 将 位 于 工作 区 中 的 项 目 局 动 完 之 后 ， 将 在 IDE 中 显示 儿 个 窗 格 (如 图 A-2 所 示 )。 


E Java - BasicVigwel/sre/net/learnZdevelap/BasicVrewsr/Maindctivity.java - Eclipse 
EB denti cdi 


B o CxXH:*-O0-Q- EGF 
dE nx 


7 Elf 国 MainActivitrjava 53 


iT 1a ua 


T-I- E 


m v E: package net.lrfa&rTn2dcvelop.Basicviewsi: 


b BE Additional 
a 5l BasicViewsl 
a GP wc 
à Hj netleamzdevelop.BasicViewsl. 
» [|f] MainActivity java. 
t ŞE gen |Genersted lava Files] 


Tuümport android.app.AÀctivity: 


gOTEITidGc 


public class Haináctivity extends Activity i4 
/** Called when che acriviry ia Tirst creata: 


publia void onCreate(Bundle gavedInsLtanceSta 


hn. 


二 日 | 经 Dutine 52 


vl$uwew 


Hio onetleamidevelop.Basickrewsl 
^9 import declarstians 
(3 MainActivity 

ğa nnireate(Bundla) : «cid 


(à new OnClickListenert) {t 
(à new COnClickListener() L...: 


b E} Android 2.2 
gh nssets 
[n iu TES 
ji AndrcidManifeztaml 
国 default properties 
p ES. BasicViews2 
b Ú BasicViews3 
b e BasicViews 
p E BasicViewss + 
b 加 BasicViewsh n: 


Cà new OnClicklistenert) [...] 
(à new OnCheckedChangeList 
(à new OnClickListener() [...| 
DisplayT past(String) : void 


zuper.ogu^Creats|[zasvedInstance3tate|.- 
setLconcentVigPw|R.laynmut.malmn); 3 
,f---Button view--- ü 
Button btnÜpen = (Button) findViewBHyId(H 
btnüpen.setünclickListeneriínaew View.U0nCl 
publio void aonClick(View v) i 
Displayloast("You have clickcd t 


//[---Button wvicw--- 

Burron brtnSave = (Burrom) findwviewHyId(H 
btnSauE.setÜOnClieckListemner(new View COncl 
LU 


public void onClickiView v) i 
DisplayIocast("You have clicked t 
t 


4 m | k 


区 Problems | @ Javadoc | 了 Declaration [ Console 13 


net.learnzdevelop.BasicVirewsl MainActivity,java - BasicViewsL/src 


图 A-2 
下 面 的 小 节 将 对 在 开发 Android 应 用 程序 时 必须 了 解 的 


些 较 重 要 的 窗 格 进行 重点 讲解 。 
A.1.2 Package Explorer 


如 图 A-3 所 示 ，Package Explorer 列 出 了 当前 位 于 工作 区 中 的 所 有 项 目 。 要 编辑 项 目 中 一 个 特 
定 的 项 ， 可 以 双击 这 一 项 ， 文 件 将 会 显示 在 各 日 的 编辑 器 中 。 

还 可 以 右 击 在 Package Explorer 中 列 出 的 每 一 项 ， 以 显示 与 所 选项 有 关 的 上 下 文敏 感 末 单 。 
例如 ， 如 果 希 望 在 项 目 中 添加 一 个 新 的 .java 文 件 ， 可 以 在 Package Explorer 中 右 击 包 的 名 称 ， 然 
后 选择 New | Class (如 图 A-4 所 示 )。 


EH Java - BasicViewsl/src/net/leam2develop/BasicViewsl/MainActivity.java - Eclipse 
Eile Edit Run Source  Mavigate Search Project Refactor Window Help 


: j 9 z E1 ; F| r o y Cum T ap T 
z TEN 司 可 | 个 Treo 0 


B T | En T E package net.learn2develop.BasicViewsi; 2 


t TS. AdditionalViews 
a Y3 BasicViewsl 
a B sre 


a [EF netlearnZdevelen e 


¥ import android.app.Activity; 


public olass MainActivity axtends Activity [ 


» |J] MainActiviy New + | Java Project 
t EX gen [Generated Javi Go Into i$ Android Project 
F mà Android 22 E 
C xdg - Es. acretz Open in New Window ak nii 
t E AdditionalViews: | z 2 : 
ca BasicViewsl D gres Open Type Hierarchy FA | B$ Package 
ioo id. AnéroidManifesor —— ShpwIn AlteShifteW r | (S Class 
4 (S src [3 default.properties PEE 
4 HH net.earn2develop.BasicViewsl p Vel BasicViews2 jg Copy Ctrl+C ; 
p 四 MainActivity javal u BasicVigws3 gz Copy Qualified Name z E 
= » xs 35i nnotakion 
D iB gen [Generated Java Files] | tS pde "Ej Paste Ct-V S 
加 | j BasicViews5 - J 
p mÀ Android 22 | i d usan X Delete Delte gi urce Fo 
csi ine | [dE BasicViewst 1S | Java Working Set 
- x b 但 Gallery Remave from Context Ctrl Alt- Shift- Dinan C3 Folder 
E | | fin | 
PARTE a pirm Build Path Imm 
ll AndroidManifest.xml b 1E» ImageSwitcher PS Alt Shift + ns 
urce + Shifta DM rum rE 
default.properties b € Manus RR MM [5 Untitled Text File 
T. | j = " | 
Basic Views p Xe» WebView 3 ; ijj Android XML File 
BasicViews3 Eig Import.. [ET JUnit Test Case 
BasicViewsd p Erport.. [T Task ; 
BasicViews5 Pur Ec | CÅ Example.. B 
ren | Declarations k E 
b GS Gallery lin VENUES F? Other.. Ctrl N 
b ES Grid — 4 Refresh F5 
b él ImageSwitcher Assign Working Sets... 


图 A-3 
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A.1.3 使 用 其 他 工作 区 的 项 目 


也 许 您 有 时 候 会 创建 多 个 工作 区 来 存储 不 同 的 项 目 。 如 果 需 要 访问 另 一 个 工作 区 中 的 项 
目 ， 通 音 有 两 种 方法 可 以 实现 这 一 点 。 

第 一 种 方法 是 选择 File | Switch Workspace( 如 图 A-5 所 示 ) 切 换 到 您 所 希望 的 工作 区 。 指 定 新 
工作 区 后 重新 局 动 Eclipse。 


88 Java - Eclipse ds 
[File] Edit Run Navigate Search Project Refactor Window Help. 


hew Atr5hiftrNr Lc F i X&-(3-Q- gig- S 
Open File... | 


Close Ctr W 
Close All Ctrl Shift- W 


Gawe Ctrl-5 


| Gawe Ås.. 


awe All Ctrl Shift 5 
Rewert 


Move... 
Rename... 
| | Refresh 
Convert Line Delimiters To 


Print.. 


| Switch Workspace CAUsersvWei-Meng Leeyworkspace3 
CAUsersWei-Meng Leeuworkspace2 
CAUsersWei-Meng Leevworkspace 
Other... 
Alt» Enter 
1InvocationTargetException.class [Ja...] 
2 Leoper.class [android.as.Looper] 


3 SendSMSLab.java [Send SMS! ab/src/...] 
4 Vigw.clazg [android view. View] 


Exit 


A-5 
第 二 种 方法 是 将 项 目 从 另 一 个 工作 区 导入 到 当前 工作 区 中 。 要 做 到 这 一 点 ， 选 择 File | 
Import...， 然 后 选择 General | Existing Projects into Workspace( 如 图 A-6 所 示 )。 
在 Select root directory 文 本 框 中 输入 包含 想 要 导入 的 项 目的 工作 区 的 路 径 ， 并 选中 这 些 项 目 


Import Projects 
Select a directory to search Far existing Eclipse projects. 


© Select root directory; — CAUsersWei- Meng Leeworkspace 
Select an import source: 


"rmm E Select archive file: || Browsen | 
4 [2 General j| Projects: 
区 Archive File E] ActivityLab [C:UsereNWei-Meng Lee\workspace\Ad + 
Ùi Existing Projects into Workspace | F7] BasiclLab (Ci LsersWei-Meng LeewarkspaceBas 
G, File System F] DatabaseLab (Cr UsereWei- Meng Leeworkspace,D|-- | Deselect All | 
E, Preferences F] D'ialogsLab (CrUsersNWei- Meng Leeworkspace|Dia ——— 
b m Cs E] FilesIOLab tC Usersv W ei- Meng LeewarkspaceFile: : 
b E EB E| HelloWorld (CA Users Wei-Meng LeewworkspaceHe 
| F] HttpLab (CAUserzWei-Meng LeeworkspaceHttpL; 
D x ing a EE — " [F] IntentLab [CAUsere Wei-Meng Lee'workspaceUnter _ 
In Blug-i opm err NN à " FERES 


jm— ENT t 
b [£2 Remote Systerns | -一 A 


四 Copy projects into workspace 
Working sets 


[7| Add project to working sets 


‘ork g EEs; 
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注意 ， 当 从 为 一 个 工作 区 将 一 个 项 目 导 入 到 当前 工作 区 中 时 ， 寻 入 项 目的 物理 位 置 保持 不 
变 。 也 就 是 说 ， 项 目 仍旧 位 于 其 原始 目录 下 。 要 在 当前 工作 区 中 保留 项 目的 一 个 副本 ， 可 选中 
Copy projects into workspace 选 项 。 


A.1.4 ”编辑 器 


根据 在 Package Explorer 中 双击 的 项 目的 类 型 ，Eclipse 将 为 您 打开 对 应 的 编辑 器 来 编辑 文件 。 
蕉 例 来 说 ， 如 果 双 击 一 个 .java 文件 ， 将 打开 用 十 编辑 源 文件 的 文本 编 — 图 A-8 所 示 )。 


加 Java - BasicViewsl/sre /net/learn2develop/BasicViews1/ MeinActivityjau java - Edips 

File Edit Run Soure  Mavigate Search Project Refactor Window Help 

F3- [E a (B gd SHO Qr EO BOT B? X Debug iğ DDMS 图 
Pe Em iHa ppro” 

[$ Package Explorer 31 x Muss 


package net. learn2develop.BasicVisewzsl: 


E AdditionalViews 
VS BasicViewsl 

(HB sre 

ü oe ee ee import android.vicw.Vicw; 

: n MamnAchiihy-aeal import andraid.widget.Button; 

E gen [Generated Java Files] import android.widget.CheckBox:; 

mj Android 22 import android.widget.RadioButton; 

2 assets import android.widget .RadioGroup; 

ip res import android.widget.Ioast; 

i AndroidManifest.xml import android.widget.ToggleButton: 

E default.properties import android.widgert.RadioGroup.OoncheckedChangeLisrcener; 


cimport android.app.Activitv: 
import android,.os.Bundle; 


public class HninActivity extends Activity { 
/** Called when the activity is first created. */ 
üCverride 
public void onCreate(Bundle savedInstanceS5tate) 1 
super.conCreate([savediInstanceB5tatae): 
setcontentView(R.layout.main); 


/fí---Burron view—-- 
Button btnOpen = (Button) findViewByvId (E.id.btnOpen): 
btnOpcen.scetonClickListcener(new Vicw.OnClickListenczr() i 
public void onClick(View v) { 
DisplayToast("YXou hawe clicked thc Open button"): - 
n j 
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如 果 双 击 res/drawable-mdpi 文 件 夹 下 的 icon.png 文 件 ， 将 局 动 Windows Photo Viewer H FEY 
来 显示 图 像 ( 如 图 A-9 所 示 )。 


| El icon.png - Windows Photo Viewer 


File ~ Prnt * E-mail Bum * Open ™ 


图 A-9 


MRN res/layout XF F HJmain.xml X fF, Eclipse &RUIduH a. EARE n eA ARE 
化 方式 查看 和 构建 UI 布局 (如 图 A-10 所 示 )。 


要 使 用 XML 手动 编辑 UI， 可 以 单 击 位 于 屏幕 撒 部 的 main.xzml 选 项 卡 ， 切 换 到 XML 视图 (如 
图 A-11 所 示 )。 


w lava - Basiiews lire s myncuk/mein xml - Eclipse 
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File Edit Run Navigate Search Project Refactor Window 


L3 
四 
-Ei 


m Package Explorer H 


E AdditionaNiews 
强 BasicYiewsl 
(28 sre 
EB neklearn2develop.BasicViewsl 
[Jj MainActivity java 
gu gen [Generated Jawa Files] 
mà, Android 2.2 
ils assets 
E> res 
E drawable-hdpi 
EE drawable-ldpi 
[2 drawable-mdpi 
Ma icon.png 
i layout 
aH] mainaml 
E values 
jd AndroidManifest;xml 
B default. properties 
E BasicViews? 
[e BasicVigws3 
X3l BasicViewst 
[e BasirViews5 
E BasicMiewsh 
E Gallery 
(e Grid 
E! ImageSwitcher 
E Menus 


TE WebView 


司 rj 


"^ Bl LinearLaynut/Stext 


ME) Java - BasicViewsl/res/laycut/main xml - Eclipse 


Help 


e ud: €*-0-«- WG- 


| rm in, mui Xx" 


Editing config: default 


= ua u- 


Device] * [Config] ~ Locale ~ | Theme 


Hello world. Mainacthity 


x 


Ee Layouts 


[A] AbsoluteLayout 

(D] DialerFilter 
[E]Expandab leListView 
[F] FrameLmynut 

[SG] Grid View 

(H) HornizontalSc rollV iew 
(T]ImageSwitcher 
(L]LinearLayeut 
[L]Listview _ 


EE Views 


(G) GestureOverlayView 

5 SurfaceVier 

(o View 

(b VieuStub 

tM WebView 

(& AnalogClock 

(RD AutoCompleteTexHiew 
(B Button 

(O CheckBox.. 


Leyout memi 
区 Problerms i^ javadoc E Declaration Bg Console HO 
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= A OxHit-O-qQ-iud-iBp- 


T Ea os hi 


HB Pac kage Explorer e 


H AdditionalViews 
TS BasicViewsl 
[iB sre 
EB. net.learn2 devel pp.BasicViewsl 
[f| MainActrety.] mea 
gi gen [Generated Java Files] 
gÀ Android 2.2 
ga. assets 
B 


ge rer 
[e drawable-h dpi 
E drawable-Idpi 
[E drawable-mcpi 

Ra icongng 
iz» layout 
aŭ mainm 

am wa lues 
加 AndroidMlanifest.«ml 
[zi default.propertiex 

(cS. BasicViews2 

(£3. BasicViews3 

TE BasicViewst 

Ë BasicViewss 

EÈ BasieViewes 

(3. Gallery 

i£. Grid 

H ImageSwitcher 

[e Menus 

ws WebMigw 


4 m 


m [E] Linesrkaycut/TextMiew 


A.1.5 “透视 图 


Eclipse”, ÆW K| (perspective æ — DUR —2H T TRI 
编辑 器 的 可 视 化 容器 。 当 在 Eclipse 中 编辑 项 目 时 ， 您 就 处 于 
图 中 (如 图 A-12 所 示 )。 
Java EE 透 视 疼 用 于 开发 企业 级 的 Java 心 用 程序 ， 它 包 合 


Javaj 4 


cTxml verziun-"I.0" encoding-"uEE-B"?» 


«LinearLayour xmlna:android-"hb5bp://schemas.android.com/apk,res,s 
android:orientation-"vartical" 


android:layout width-"filil parent" 
andrznoid:laynut height- "Er] 1 parenE"» 


£TextViewd 


andrznid:laynut width-"F:11 parenE" 


android: layout height= x wrap cantant m 


android:itemxt-"gstring/hallo" 


ru 


rF 


H EF Debug ig DOMS [a] Java | 3% Jawa EE 


Ew BB| rt B - r3- ^ E] 


Ef $F Debug i DOMS EX Java | 得 Java EE 


¿Burton android:id-"geid/btnsava" 


android:layout width-"Fill parant" 
andrnoid:laynut heighte-"wrep canbenE" 


android:rexr-"Zave" /> 


xButton android:id-"Biridg/bbnOpen" 


andrnüid:laynut width-"wrap c-anbenE" 
android: layour height= "wrap panrentr" 
android:texzt-'"Onan" /> 


«ImangeBurron android:id-"Berd/hbtnimgr" 


android:layout width="fill parant" 
android:layout height- "vrap cantent" 
anndrnid:src-"gdrzsweble;g/rcon" j> 


ZEditlexc android:id-"Béid/EgRENama" 


android:layout width-"fill parent" 
m 


| Layout, mainam 


Er 区 Problems e lavadac E Declaratian E Consoles z bh. 
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o=o z^ 
vect-iti 
| L | LinearlLayout 
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与 之 相关 的 其 他 模块 。 

通过 单 击 透视 图 的 名 称 可 以 进行 透视 图 的 切换 。 如 
果 透 视图 名 称 没 有 显示 ， 可 以 单 击 Open PerspectivefZ El -一 
添加 一 个 新 的 透视 图 (如 图 A-13 所 示 )。 ^ Debug 

DDMS 透 视图 包含 了 与 Android 模 拟 器 和 设备 进行 通 | .Js one 
信 的 工具 。 在 附录 B 中 将 进行 详细 介绍 。Debug 透 视图 包 Other. 
含 了 用 于 调试 Android 应 用 程序 的 窗 格 ， 本 附录 稍 后 将 对 - 
此 进行 详细 介绍 。 


A.1.6 ”命名 空间 的 目 动 导入 


特定 的 类 时 ， 需 要 导入 适当 的 命名 空间 ， ee 


import android.app.Activity; 


import android.os.Bundle; 


由 于 Android 库 中 类 的 数目 非 党 已 TE: >N 
K " 要 记 住 每 一 个 类 所 属 的 正确 的 命 2 z5 package net.learn2develop. PnP 
间 不 是 一 件 容易 的 事 。 垃 运 的 是 ， Eclipse $ import android.app.Activity:[] 
可 以 帮 您 找到 正确 的 命名 宇 X [RH], 使 得 您 只 H I public class MainActivity extends Activity | 


/** Called when the activity is first created. */ 


TE nfi UbIogo n] DAC o Ml 


public void onCreate(Bundle savedInstanceSrate) { 


a A-1 4 展示 了 我 所 声 明 的 个 Butt on - super.onCreate (anelin aee) - 


setContentView(R.layout.main): 


类 型 的 对 象 。 由 于 我 没有 为 Button 类 导 | //-—BRatton vieu—- 


= v = "x Button btnOpen = (Button) findViewById(R.id.btnOpen); 
入 正确 的 命名 ze jH] , Eclipse 在 语句 F ra | : [ ds Button cannot be resolved to a type ickListenerí) { 
提示 一 个 错误 。 当 将 鼠标 移动 到 Button : 7 quick fixes available: uc Dou Feika 


n idi 


类 的 上 h 时 ， Eclip se 会 FI T ZW m 个 修 改 建 : © Create class 'Button' 


- © Create interface 'Button' 
议 列 表 。 在 本 例 中 ， 我 需要 导入 android. | 9 Add type parameter Button to "MainActivity l 
na ET "a o Addtype parameter 'Button' to 'onCreate(Bundle)' —— ; 
widget.Buttoníp4A^[H]. 'Éililmport | ~ Q Create enum "Button: ckListener() 
. 四 PO ex project setup... 
‘Button’ (android.widget) t T2 14 E X fF 
开头 添加 导入 语句。 或 者 ， 可 以 使 用 如 下 
的 组 合 键 : Control+Shifttro。 这 一 组 合 刍 


将 使 Eclipse 自动 导入 您 的 类 所 需要 的 所 有 命名 空间 。 
A.1.7 ”代码 完成 


Eclipse 另 一 个 非常 有 用 的 功能 就 是 支持 代码 完成 。 当 您 在 代码 编辑 器 中 输入 内 容 时 ， 代 三 
完成 会 显示 一 个 上 下 文敏 感 的 相关 类 、 对 象 、 方 法 以 及 属性 名 称 的 列表 。 例 如 ， 图 A-15 展 示 了 
起 作用 的 代码 完成 功能 。 在 我 输入 单词 fn 时 ， 通 过 按 下 CtrlI+Space 组 合 键 能 够 激活 代码 完成 功 
能 ， 这 时 将 出 现 一 个 以 fn 开头 的 名 称 列表 。 

要 选择 所 需 的 名 称 ， 直 接 在 其 上 双击 或 者 使 用 光标 高 亮 显示 它 并 按 Enter 键 就 行 了 。 

在 一 个 对 象 / 类 名 之 后 输入 “.” 时 ， 代 码 完 成 也 可 以 起 作用 。 图 A-16 展 示 了 一 个 示例 。 


he Save button") 


public void onCreate (Bundle savedInstanceS5tate) 1 
super.onCreate(savedInstanceState): 
setContentView(R.layout.main):; 


//---Button view--- 
Button brtnOpen = ri 


& findViewByld(int id) : View - Activity 

$ finalize() : void - Object 

& finish() : void - Activity 

& finishActivity(int requestCode) : void - Activity 


& finishActivityFromChild(Actrity child, int requestCcde) : von 
& finishFromChild(Activity child) : void - Activity 


Tm | t 
Press 'Ctrl*5pace' to show Template Proposals 
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A.1.8 Æ} 


重 构 是 现代 IDE 文 持 的 一 个 非常 有 用 的 功能 。 
Eclipse 文 持 大 量 的 重 构 功 能 ， 可 用 来 有 效 地 进行 应 
用 程序 开 友 。 

在 Eclipse 中 ， 当 将 光标 放 到 一 个 特定 对 象 / 变 
量 上 时 ， 编 辑 器 将 突出 显示 当前 源 中 所 选 对 象 出 现 
的 所 有 地 方 (如 图 A-17 所 示 )。 

这 一 功能 对 于 确定 一 个 特定 对 象 在 代码 中 的 位 置 
可 右 击 它 并 选择 Refactor | Rename...( 如 图 A-18 所 示 )。 


public class MainActivity extends Activity i 
/** Called when the activity is first created. */ 
BOverride 
public void onCreate(Bundle savedInstanceState) 1{ 


zuper.onCreate[savedinstanceS5rtartse!: 
setContentVie < Undo Typing Ctrl-Z 
Revert File 
//---Button 
Button leta 
btnopen.setOrn 
public vo 
Displ 


avwe Ctrl- 8 


Üpen Declaration 

Open Type Hierarchy 

Open Call Hierarchy Ctrl-- Alt-- H 
um Show in Breadcrumb Alt-Shift-B 
S E Quick Outline Cirk- O 
Button btn3ay Quick Type Hierarchy Ctrl«- T 


btn5ave.setOm Show In Alt-Shifta W 
i 
public vo Cut Ctrl- X 


Displ Copy Ctrl-- C 
Copy Qualified Name 
Paste Ctrl- V 


IH: 


/ / ---CheckBo 
CheckBox chec 
checkBox.setO Source Alt- Shift- 5 


Refactor Alt-Shift« T 
Surround With Alt-Shift-Z 
Local History 


Quick Fix Ctrl-1 


图 A-18 
在 输入 对 象 的 新 名 称 后 ， 该 对 象 出 现 的 所 有 
地 方 将 动态 变化 (如 图 A-19 所 示 )。 
对 于 重 构 的 详细 讨论 超出 了 本 书 的 范围 。 想 
要 了 解 Eclipse 中 更 多 关于 重 构 的 信息 ， 可 以 访问 


www ibm.com/developerworks/library/os-ecref/ 。 


+ 


k 


k 


k 


k 


附录 A 使 用 Eclipse 进行 Android 开 发 


public void onCreate(Bundle savedInstanceState) 1{ 
super.onCreate(savedInstanceState): 
setContentView(R.layout.main): 


Toast. 


|o class: Classcandroid.widget.Toast» 
o? LENGTH LONG : int - Toast 
o LENGTH SHORT : int - Toast 
g makeText(Context context, CharSequence text, int duration) : 
g makeText(Context context, int resId, int duration) : Toast - Tc 
this 


m | t 
Press 'Ctrl+5pace' to show Template Propasals 


图 A-16 


//---Button view--- 
Button btn ope n = (Button) findViewById (R.id.btnOpen): 
brtnOpen.setonClickListener(new View.OmnClickListener() i 
public void onClick(View v) 1 
DisplayToast("You have clicked the Open button"); 


图 A-17 


是 非常 有 用 的 。 要 改变 一 个 对 象 的 名 称 ， 


Rename... Alt- Shift--R 
Move... Alt- Shift- V 


Change Method Signature... Alt«Shift« C 
Extract Method.. Alt-Shift- M 
Extract Local Variable... Alt--Shift--L 
Extract Constant... 

Inline... Alt-Shift-l 
Convert Local Variable to Field... 

Extract Interface... 

Extract Superclass.. 

Use Supertype Where Possible... 

Pull Up... 

Push Down... 

Extract Class... 

Introduce Parameter Object... 


Introduce Parameter... 


Generalize Declared Type... 


//---Button view--- 
Button mma = EE on) Ë 有 (R.id.btnOpem);: 
- OnClickListener() i 


Enter new name, press Enter to na T 


DisplayToast ("You have clicked the Open button"): 


图 A-19 
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A.2 调试 


Eclipse 支持 在 Android 模 拟 器 以 及 真正 的 Android 设 备 上 进行 应 用 程序 的 调试 。 当 在 Eclipse 中 
按 下 F11 键 时 ，Eclipse 将 首先 确定 是 否 已 经 在 运行 一 个 Android 模 拟 器 的 实例 或 是 连接 了 一 个 真 
实 设备 。 只 要 有 一 个 模拟 器 (或 设备 ) 运 行 ，Eclipse 就 会 将 应 用 程序 部 署 到 运行 中 的 模拟 器 或 已 连 
接 的 设备 上 上。 如果 既 没 有 模拟 器 运行 又 没有 连接 设备 ，Eclipse 将 目 动 司 动 一 个 Android 横 拟 器 的 
实例 并 将 应 用 程序 部 署 在 其 上 面 。 

如 果 有 多 个 模拟 器 或 设备 连接 ，Eclipse 将 提示 您 选择 一 个 目标 模拟 器 /设备 ， 以 便 在 其 上 部 
署 应 用 程序 (如 图 A-20 所 示 )。 选 择 一 个 您 想 使 用 的 目标 设备 ， 然 后 单 击 OK 按钮 。 


Target 
| Android 2.2 Emulator WY Android22 
emulator-5556 Android 2.1 Emulator 其 Android 21-updatel 


(^^ Launch a new Android Virtual Device 
| AVD Name Target Name Details... 


GoogleAPIs 2.2 Emul.. Google APIs (Google Inc.) Start 


Refresh 


Mana ger... | 


图 A-20 


如 林 想 局 动 一 个 新 的 模拟 器 实例 来 测试 应 用 程序 ， 可 选择 Window | Android SDK and AVD 
Manager /n zJAVDA Ph 2s. 


A.2.4 设置 断 点 
设置 断 点 是 临时 暂停 应 用 程序 的 执行 ， 然 后 检查 变量 和 对 象 内 容 的 一 个 好 方法 。 


要 设置 一 个 断 点 ， 可 双击 代 但 编辑 器 中 的 最 左 列 。 图 A-21 展 示 了 设置 在 一 个 特定 语句 上 的 断 点 。 


//---Button view--- 

Button btnOpen = (Button) findViewById(R.id.btnCpen); 

btnOpen.setOnClickListener(new View.OnClickListener() 1 
public void onClick(View v) { 


String str = "You have clicked the Open button"; 
DisplayToastí(str):; 


图 A-21 


当 应 用 程序 运行 到 第 一 个 断 点 时 ，Eclipse 将 显示 一 个 Confirm Perspective Switch 对 话 框 。 从 
根本 上 说 ， 它 希望 切换 到 Debug 透 视图 。 为 了 防止 再 次 出 现 这 一 窗口 ， 在 底部 选中 Remember my 
decision 复 选 框 并 单 击 Yes。 

MÆ, Eclipse K Hi zn T Bere Cn E A-22ÀT7R)« 


MRA 使 用 Eclipse 进行 Android 开 发 


CH Debug - Bas Visas VETERE ERE UE ESSA NES - Eclipse 

File Edit Run Source Novigate Sench Project  Refactor Window Help 
ri-lue iBiuHi-0O-Q-idos4-,$90).8m rif Debug] Doms Bj lava 4# Java EE 
4-9 -c- 


$ Debug 只“ Hb Servers| = [t4 Variables | Va Breakpoints (£X Expressions 52 ^ 


S P EH Xoc£6nzmeU" Hw B| + X XU 


pP Thread [«1» main] [Suspended {breakpoint at line 27 in PainActrarty di)) = Waluz 
E MainActivitySL.onClick(View] ling 27 
三 Button [Vier perfe rmClic ki) line: 2408 
三 ViewsPerfprmclick.run() line: 8816 
三 ViewfnattHandler] handleCallback(t essage) lime: 587 
三 ViewRootiHandler).dispetchMessage(Messa ge) line: 82 
E Looper.loop[] ling 123 


null 
null 
null 


You have clicked the Open ... 


E an a B aaa 
"o —— | -— ai a 


» 


z- 


T main xml f Instrurmentatinn. class D dai ru ctrnby. pens * wi la T wi e 三 Lom 日 


HB netleam2develop.BasicViewsl 


/í---Buttnn vitew--- = import declarations 
Button btnüpen = (Button) findViewById[R.id.btr ic] Main&ctrarty 
bcnüOpen.aecOnClickLisrener [new view onc1iet1st f] @a oncreate(Bundla) - «cid 
poblic void onClick |View v) 1 Cà new OnClickListenerQ 1...] 
String str ~ "You have clicked the Open @ a onClick(Vigew) : void 
G Cà nrw OnClickListener( |..] 
(à new OnClickListener[) /..] 
Cà new OnChecked Chan gel istener() t...) 
和 new OnClickListenerQ J...] 
DisplayTeast(String) : cid 


/í---Buccon view--- 
Huttnn btnsavB = (Button) rindViewById|E.id.Bbtn 
9 btn&Save.setOnClickListener new View.OnClickList:|-| 


Nm " -— a Im F 


E Console 12 E Tasks] E BE| rt B - r3 7 7 Eli Logt 27 CIGTOISTSIE S EE ale) 


Android La | 
[2010-11-28 22:44:54 一 BasicViewsl] ----------------------. + 3 
[2010-11-22 22:44:54 — BasicViewsl] Android Launch! 7 || Filter: 

k 


| Writable | "-—nzo | zu eure ie 


此 时 ， 可 以 利用 如 图 A-23 所 示 的 不 同 的 选项 (Watch、Inspect 和 Display)， 
象 /变量 来 得 看 它们 的 内 容 . 


//---Button view- 
Button btnOpen = 
btnOpen.setonClic 


Step Into Selection Ctrl F5 
Watch 
Inspect Ctri-Shift- I 
Display Ctri-Shift- D 
! Execute Ctrl+U 
//---Button view- : 
Button btn5ave = Run ta Line Ctrl- R 


//---Button view--- 
Button btnOpen = (Button) findViewByIld(R.id.btnOpsen): 
btnüOpen.setOonClickListener(new View.OnClickListener() 1 
public void onClick(View v) 1 
String str = "You have clicked the Open button"; 


4 O str- "You have clicked the Open button" (1d2830067779976) 
B count- 32 
m hashCode- 561881161 
a| offset- 0 
p ef value- (id-830067780008) 


//---Button view--- 
Button btnSave = (E 
btnSave.setOonClickLij 
1 


public void onC 划 You nave clicked the Open button 


DisplayIoas 


//---CheckBox--- 


图 A-24 


此 时 ， 有 以 下 几 个 选项 可 以 继续 执行 : 

€ Step Into 一 一 按 F5 键 步 进 到 下 一 个 方法 调用 /语句 。 

€ Step Over 一 一 按 F6 键 跳 过 下 一 个 方法 调用 ， 不 进入 此 方法 中 。 
€ Step Retum 一 一 按 F7 键 从 已 经 进入 的 方法 中 返回 。 

€ Resume Execution 一 一 按 F8 键 继续 执行 。 


右 击 任意 选择 的 对 
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A.2.2 ”异常 


在 Android 中 进行 开发 时 ， 您 将 会 页 到 大 量 运行 时 异常 ， 阻 止 您 的 程序 继续 运行 。 运 行 时 寞 
常 的 例子 包括 以 下 内 容 : 

e 5m MS) 

e 没有 指定 应 用 程序 所 需 的 权限 

e 算术 运算 异常 

图 A-25 展 示 了 一 个 应 用 程序 产生 寞 常 时 的 当前 状态 。 在 这 一 示例 中 ， 我 试图 从 我 的 应 用 程 
序 中 上 发 送 一 条 SMS 消 县。 当 消 县 刚 要 友 送 时 ， 它 朋 训 了。 


W Debug - Source nat found. - Edipse -— 


(B PETE (*-0-qS- Bos- Ei [fs Debug is DOMS & Ine. iS Java EE 


$E Debug 5i ^. 4fb Servers. ~= El |t Variables EZ ~ Se Breakpoints| ED ED UB 
Wege» gm m —.e6mi-wie" | Valuc 
pf. Thread [«1» mein] (Suspended [exception SecurtyExcept < a thi I5rnsS5tubSProxy (idz830067782648) 
= EmssstubSProuy.sendText(5tring, String, String, Pendi GO data Parcel [id=830067561700) 
ES S5msManager.sendTexthlessage(Strin g, String, String, [T © _reph Parcel [id -E300876561784) 
三 SendsMSLab.sendSMS(String, String) line: 38 — 
= SenclsM S. ab.acceszSüSendsMSI ab, String, String) lir 
三 5endSMSi ab51.enClickiVrew) line: 27 


ource nat found. An outline is not available, 


| 


Il. Ec x x ™ un M 3 -—- = 
|| E Console 3: ^«, Taks G Gil et B - P * 7 B tX SRCRORVECIR HE ASER Mans 
| Android | 
|| [2010-11-30 11:18:11 - Send3MSLab] Automatic Target + | 
|| [2010-11-30 11:18:13 — 5endsM5Lab] Applicarion alre T a 

4 | LJ | k 


im : Launching Bazicviewsl 


图 A-25 


各 式 的 窗口 并 不 能 真正 识别 异常 发 生 的 原因 。 要 寻找 更 多 信息 ， 可 以 在 Eclipse 中 按 F6 键 
跳 过 当前 语句 。Variables 窗 口 指 出 了 异常 的 原因 ， 如 图 A-26 所 示 。 在 本 例 中 ， 异 常 原因 是 缺少 
SEND SMS B. 


E [3 Debug | fi ppM5 & Java. 59 Java EE 


Hp” =g 
Value 
InvocationTargetException  (id-83006778358B) 
b © exception SecuntyExcepbon (id=830067782864) 


ava.lang.S5SerurityExceprion: Sending SMS message: User 10039 does not hawe android.permizzionn.5END SM5. + | 


A-26 
为 了 补救 ， 只 要 在 AndroidManifest.xml 文 件 中 添加 以 下 权限 声明 就 行 了 : 


«uses-permission 


android:name-"android.permission.SEND SMS"/» 


使 用 Android 模 拟 器 


Android {Uas Ht Y Android SDK， 它 是 一 个 很 有 用 的 工具 ， 可 以 帮助 您 测试 应 用 程序 而 
不 需要 购买 一 台 真 实 设备 。 虽 然 您 应 该 在 部 署 应 用 程序 前 在 真实 设备 上 对 其 进行 彻底 的 测试 ， 
但 模拟 器 还 是 可 以 模仿 真实 设备 的 大 多 数 功能 。 模 拟 器 是 一 个 在 项 目 开 发 阶段 应 该 利用 的 非常 
方便 的 工具 。 本 附录 提供 了 用 于 掌握 Android 模 拟 器 的 一 些 常见 的 提示 和 技巧 。 


B.1 _ Android 模拟 器 的 使 用 


正如 在 第 1 章 所 讨论 的 ， 可 以 使 用 Android 横 拟 器 ， 通 过 创建 Android Virtual Device(AVD) 来 
模拟 不 同 的 Android 配 置 。 

启动 Android 模 拟 器 的 方法 是 在 Android SDK and AVD Manasger 窗 口中 直接 启动 创建 好 的 
AVD( 如 图 B-1 所 示 )。 直 接 选 择 AVD 并 单 击 Start 按 钮 。 可 以 选择 将 模拟 器 缩放 到 一 个 特定 的 大 小 
TI i 7v as DPI. 


Android SDK and AVD Manager 


List of existing Android Virtual Devices loceted at Ch Users Wer- Meng Leesandroidyavd 
Available Packages AVD Mame Target Mame Platform APILevel 
*” Android 2.1 Em.. Android 21-updatel 2l-upda.. 了 

sr GnagleAPI: 21... Google APIs [Google Inc.) 

"v Android 2.2 Em... Android 2.2 

v GoegleAPIs 2.2.. Google APIs [Google Inc.) 

v^ WVGA Google APIs [Google Inc.) 

** SamsungGalaxy.. GALAXY Tab Addon [Samsung Elect.. — 2.2 


£x Launch Options 


Skin: HVGA (320480) 
Density: Medium (150) 
Scale display to real size 


Screen Size (in: 3 — 


或 者 ， 在 Eclipse 中 运行 一 个 Android 项 目 时 ， 自 动 启 动 Android 模 拟 器 来 测试 应 用 程序 。 可 以 
在 Eclipse 中 为 每 一 个 Android 项 目 定 制 Android 模 拟 器 ， 只 要 选择 Run | Run Configurations。 选 择 


Android 编 程 入 门 经 典 


左边 位 于 Android Application 下 的 项 目 名 称 (如 图 B-2 所 示 )， 就 会 在 右边 看 到 Target 选 项 卡 。 在 其 
中 可 以 选择 用 来 进行 应 用 程序 测试 的 AVD， 以 及 选择 模拟 不 同 的 场景 ， 如 网 速 和 网 络 延 迟 。 


ux Run Configurations 


Cre ate, manage. and run configurations 
Android Application 


[E ax|us- Name: AdditionalViews 
type filter text [E] Android ~ 
[5] Android Application + Deplzyment Target Selection Mode 
C» Manual 
(i Automatic 
Select a preferred Android Virtual Device for deployment: 

AVD Name Target Marne 
[7] Android 之 Ernulator Android 2.2 
[7] GoogleAPIs 2.2 Emulator Google APIs [Google Inc.) 
[7] wYGAS54 Google APIs [Gangle Inc.) 
[E] SamsungGalaxyTab GALAXY Tab Addon (Samsu... 之 


fef] ImageSwitcher 
[c LBS 
fe] Menus 
fef] SendsMSLab 
回 WebVigw 
Ji Android JUnit Test Emulator launch parameters: 


8 Apache Tomcat | 
© Eclipse Application Network Speed: 
ES Eclipse Data Tools Heimat Laeneg: [None -] 
E Generic Server 
8 Generic Server(External L 四 Wipe User Data 
8 HTTP Preview [El Disable Boot Animation 
Ej J2EE Preview Additional Emulator Command Line Options 
Java Applet 
E Java Application 
Ju JUnit T 

3 | m | F 


|| Filter matched 32 of 32 tems 


图 B-2 


B.2 XXHGEXHJAVD 


有 时 ， 设 备 制 造 商 提供 了 它们 自己 的 AVD， 可 用 于 模拟 在 它们 的 设备 上 运行 应 用 程序 。 
三 星 公 司 就 是 一 个 好 的 示例 ， 它 提供 了 Samsuneg Galaxy Tab(http://innovator.samsungmobile.con/ 
galaxyTab.do) 附 加 组 件 来 模拟 它们 的 Samsune Galaxy Tab 平 板 电 脑 。 要 安装 Samsung Galaxy 
Tab 附 加 组 件 ， 首 先 在 Eclipse 中 局 动 Android SDK and AVD Manager， 人 然后 在 对 话 框 左 侧 选择 
Available Packages 选 项 (如 图 B-3 所 示 )。 


Android SDK and AVD Manager -一 一 


Virtual Devices - 
Installed Packages Sites, Packages and Archives 


E] https;//dl-ssl.google.com/android/repository/repository.xml 


Description 
SDE Source: https://dl-ssl.google.com/android/repository/repository.xml 


Add Add-on Site. | | Delete Add-on Site... | [V] Display updat | 


图 B-3 
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在 屏幕 旗 部 ， 单 击 Add Add-on Site... 按 钮 并 输入 以 下 URL: http://innovator.samsungmobile. 
coimy/android/repository/srepository.xml( 如 图 B-4 所 示 )， 然 后 单 击 OK 按 钮 。 


Android SDK and AVD Manager 


This dialog lets you add the URL of a new add-on site. 


An add-on site can only provide new add-ons or "user" packages. 

Add-on sites cannot provide standard Android platforms, docs or samples packages. 
| Inserting a URL here will not allow you to clone an official Android repository. 
| Please enter the URL of the repository.xml for the new add-on site: 


http://innovator.samsungmobile.com/android/repository/srepository.xml 


B-4 
现在 您 应 该 看 到 有 和 额外 的 包 可 用 了 (如 图 B-5 所 示 )。 选 中 此 包 并 单 击 Install SelectedTZ Hl . 


Fa Android SDK and AVD em 


Sites, Packages and Archives 


[71A https://dl-ssl.google.com/android/repository/repository.xml 
E i — ir rn eim mrs ei iiri i iR 


Description 
Android + Google APIs for GALAXY Tab, APIS, revision 1 


| Delete Add-on Site... | [V] Display updat: [Refresh EE | 


B-5 
在 弹出 的 对 话 框 中 ， 单 击 Accept 接 受 许可 协议 ， 然 后 单 击 Install 来 下 载 并 安装 包 。 
当下 载 的 包 安 装 完 毕 ， 您 束 可 以 基于 最 新 下 载 的 包 创 建 一 个 新 的 AVD。 在 Android SDK and 
AVD Manasger 窗 口中 选择 Virtual Devices 项 并 单 击 New 按 钮 。 
按 图 B-6 所 示 为 新 的 AVD 命 名 。 单 击 Create AVD 按 钮 来 创建 这 个 AVD。 
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SamsungGalaxyT ab 


"al lm 


Available Packa 


LI Size: 


© file: | 


(& Built-in: 
© Resolution: | 


Hardware: 


Create new Android Virtual Device (AVD) 


Default (GALAXY Tab) x 


Property Value i 
Abstracted LCD densi 240 | 
: sny | | Delete 
Accelerometer yes E| —— — 
Max VM application hea... 24 | 
yes 
Camera support yes = 


| Browse... 


x | 
| 


图 B-6 


要 启动 SamsuneGalaxyTab AVD， 可 选中 它 并 单 击 Start... 按 钮 ， 这 时 将 显示 Launch Options 对 


话 框 (如 图 B-7 所 示 )。 


Android SDK and AVD Manager 


List of existing Android Virtual Devices located at C'UsersWei-Meng Lee android Vavd 


Available Packages 
v Android 2.1 Emulator 


w" GoogleAPIs 21 Emula... 


v Android 2.2 Emulator 


v' GoogleAPIs 2.2 Emula... 
w" Samsu ngGalaxy Tab 


Target Name 

Android 2.1-updatel 

Google APIs (Google Inc.) 
Android 2.2 

Google APIs (Google Inc.) 
GALAXY Tab Addon (Samsun... 


Skin: GALAXY Tab (600x1024) 


Density: High (240) 
Scale display to real size 


Screen Size (in); 7 
Monitordpi 96 [2] 


如 果 想 要 重新 调整 模拟 器 的 大 小 ， 可 选中 Scale display to real size 选 项 。 如 果 您 在 一 个 小 的 
显示 右上 运行 模拟 器 的 话 (例如 在 一 个 笔记 本 电脑 上 )， 这 就 非常 有 用 了 。 指 定 屏 缮 大 小 并 单 击 
Launch 按 钮 来 局 动 模拟 器 。 图 B-8 展 示 f Samsung Galaxy Tab 模 拟 器 。 
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| $ 5556:SamsungGalaxyTab = emm mm 


Android 


zie: 


Sunday December5 — 


B.3 模拟 真实 设备 


除了 使 用 Android 模 拟 器 来 测试 Android 的 不 同 配 置 以 外 ， 还 可 以 使 用 由 设备 制造 商 提 供 的 系 
统 映 像 ， 利 用 模拟 器 来 模拟 真实 设备 。 

例如 ，HTC 为 其 运行 Android1.5 和 1.6 的 设备 提供 了 映像 (http://developer.htc.com/google-io- 
device.html#s3)。 您 可 以 下 载 一 个 设备 的 系统 上 映像， 然后 使 用 该 系统 映像 利用 Android 模 拟 器 来 
模拟 真实 设备 。 这 里 将 讲述 如 何 做 到 这 一 点 (理论 上 ， 这 对 任何 版 本 的 Android 都 有 效 )。 


注意 : 如 果 使 用 HTC 的 映像 ， 您 应 该 能 够 尼 动 模拟 器 ， 这 是 毫 无 问题 的 。 
然而 ， 它 不 能 局 用 网 络 。 一 些 好 心 人 上 传 了 一 个 修改 后 的 运行 得 很 好 的 映像 。 
您 可 以 试 着 在 www.4shared.conygetx6pZm3-WyVsystem.html 上 下 载 。 


首先 ， 使 用 Android SDK and AVD Manager， 创 建 一 个 新 的 AVD。 在 HTC 这 个 示例 中 ， 利 
用 Android 1.6 作 为 平台 创建 一 个 AVD。 这 个 AVD 位 于 C:\Users\<username>\.android\avd\<avd_ 
name>.avd 文 件 夹 下 。 如 图 B-9 所 示 ， 新 创建 的 AVD 在 该 文件 夹 中 只 包含 两 个 文件 。 

使 用 下 载 的 系统 映像 ， 将 system.img 文 件 复制 到 AVD 文 件 夹 下 ， 如 图 B-10 所 示 。 
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= 
D «€ 


awd + HTC.avd = | i * *€ android + awd + HTC.avd 


Organize ™ Organize * Burn disc image ™ Share with * 


Fr Favorites ne l| Xr Favorite: zs Mame | Date modified Type 


BE Desktop E it | config.ini P ]| E Desktop H configni 12/6/201010:39 PM — Configuration sett... 
m Downloads lel userdata.imqg | | "m Downloads ie): "mg 1/1/200912:00 AM — DisclmageFile — 


E] Recent Places | E] Recent Places rm RE 12/6/20101039 PM Disc Image File 
n 2 加 
Dropbox Dropbox 


图 B-9 图 B-10 


90000 


m o (mb 


© 00O 


Touch the android to begin. shet leth iha 
ez |x 


十 Emergency dial | | Change language | 林产 三 一 一 


图 B-11 


fas nT EJ FH fa 和 的 Google 账 户 进行 登录 (如 国 B- 12 所 示 )。 当 提示 请 动 屏幕 以 打开 键 往 时 ， 按 下 
Ctrl+F11 组 合 键 改 变 模拟 器 的 方向 。 这 个 动作 可 使 模拟 器 相信 您 正在 滑动 屏幕 来 打开 键盘 。 


| & 5554HTC 


sign in with YoUr Google account: 


Touch any text box to start typing 


By signing in, you agree to the Google and Additional Privacy Policies. 


irum c pi pea e im 
mE Ba sasaaa 


图 B-12 


一 旦 登录 成 功 ， 您 将 能 够 在 模拟 器 上 浏览 Android Market( 如 图 B-13 所 示 )。 


B.4 


| 5554HTC 


Games Downloads 


Featured 


[» Cue Fun Pro 


5pniceLaop Airie o hw le |a |v " 


6 T^ ^ 
0000 


MARAMARAMA 
maa 


u-— g Jsp Telet ied ta 


(as Doodle Jump 
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模拟 SD 卡 
如 果 创 建 了 一 个 新 的 AVD， 那 么 可 以 模拟 存在 着 一 张 SD 卡 (如 图 B-14 所 示 )。 


拟 的 SD 卡 的 大 小 (图 中 ， 大 小 为 200MiB)。 


或 者 5 


附录 B 


使 用 Android 模 拟 器 


直接 输入 想 模 


可 以 通过 首先 创建 一 个 磁盘 映像 并 将 其 附加 到 AVD 上 ， 来 模拟 Android 模 拟 器 中 的 一 


张 SD 卡 。mksdcard.exe 实 用 程序 (也 位 于 Android SDK 的 tools 文 件 夹 下 ) 可 以 用 来 创建 一 个 ISO 磁盘 
映像 。 下 列 命令 创建 一 个 大 小 为 2GB 的 ISO 映 像 ( 还 可 参见 图 B-15): 


mksdcard 2048M sdcard.iso 


T Create new Android Virtual Device (AVD) 


Name: 


Target: 
SD Card: 


AndroidEmulator 


Android 2,2 - AFI Level 8 


ose w — 
om 


2 
edipi E ai 


i 
Property Value | 
Abstracted LCD density — 160 | 
| 


| C Override the existing AVD with the same name 


ER COM indpaziystern3 Zu madexs 


D:NBndroid 2.2*andgzoid-zdk-windows*toals?mksdca 


rd 2845 


IM sdcard.is 


EN -mj 
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一 旦 创建 了 映像 ， 就 可 以 指定 ISO 文件 的 位 置 了 ， 如 图 B-16 所 示 。 


| 883 Create new Android Virtual Device (AVD) 


图 B-16 


B.5 模拟 具有 不 同 屏幕 大 小 的 设备 


除了 模拟 SD 卡 外 ， 偿 可 以 模拟 具有 不 同 屏 硕大 小 的 设备 。 图 B-17 展 示 了 AVD 在 模拟 
WVGA854 外 观 ， 其 分 辨 率 是 480X 854 ZK. Æ> LCDR R RE 45240, XX E VABE SER 


寸 具有 240 个 像素 。 
对 于 您 选择 的 每 一 个 目标 ， 都 有 一 个 可 用 的 外 观 列表 。Android SDK 文 持 以 下 屏幕 分 辨 率 : 
€ QVGA —— 240X320 
€ WQVGA400 — 240 X 400 
€ WQVGA432 一 240X 432 
€ HVGA ——320X 480 
€ WVGA800 —— 480 X 800 
€ WVGAS854 —— 480X854 


图 B-18 展 示 了 使 用 WVGAS854 外 观 的 Android 模 拟 回 。 
Target Ce 


SD Card: 
e Size: 


006000 


See all your apps. HT - XA / | 
dL  K-—— | dudar o (mp c 
OR | xz |]| — ©0000 


| = = 
Property Value [New... | 
Abstracted LCD density — 240 E | ^ |2 |s |4 |s |e |z ls | |o | 
7 | sen iie 
mius diia ; i i " E ji DEL 
e 


ra 
[iz |x |c lv Je In m|. 
EAR I usa ca 


[ | Override the existing AVD with the same name 


B.6 模拟 物理 功能 


附录 B 使 用 Android 模 拟 器 


除了 模拟 具有 不 同 屏幕 大 小 的 设备 之 外 ， 还 可 以 选择 模拟 不 同 的 人 硬件 功能 。 当 创建 一 个 新 
AVD 时 ， 单 击 New 按 钮 将 显示 一 个 可 用 于 选择 打算 模拟 的 硬件 的 类 型 的 对 话 框 (如 图 B-19 所 示 )。 

例如 ， 如 果 想 模拟 一 个 没有 触摸 屏 的 Android 设 备 ， 可 以 选择 Touch-screen support 属 性 并 单 
击 OK 按 钮 。 回 到 AVD 对 话 框 ， 将 该 属性 值 从 yes 变 为 no( 如 图 B-20 所 示 )。 


f] Create new Android Virtual Device (AVD) (02$ | 


Mame: mecum 


Target: Android 2.2 - APILevel& 
SD Card: 
© Size: | 200 [MiB | 


ELE | androidLsdk_windowsuioolsvsdcarndiso 


Skin: 
(Q! Built-in: Default [HVGA] - 
© Resolution: i |a | 
Hardware: 
Froperty Value 
Abstracted LED densi 160 EEA 
racte imd | Delete | 
Property: 
I| Type: 


DPad support 
Description: Accelerometer 
| Maximum horizontal camera pixels 
Cache partition size 
Audic playback support 
Track-ball support 
Maximum vertical camera pixels 
— Camera support 
Battery support 
Teuch-screen support 
Audic recording support 
GPS support 
Cache partition support 
Keyboard support 
Max VM application heap size 
Device ram size 


G5M modem support 


图 B-19 B 


noval of virtual SD Cards. 


n 


—- = 


u Create new Android Virtual Device (AVD) 


Name: 


Target: 
SD Card: 


Skin: 


perum B 


Android 2.2 - API Level & 


@ Size — 


O file | 


(&) Built-in: Default (HVGA) 


(^) Resolution: 


Property 
Abstracted LCD density 
Touch-screen support 


|_| Override the existing AVD with the same name 


图 B-20 


xx 8] e — ^ dmt fübb Be SCREHJAVDOGWRLIE UG. HIP AREH BUERTEBESE LAE) 
还 可 以 使 用 Android 模 拟 器 来 模拟 位 置 数据 。 第 9 章 详细 讨论 过 这 一 点 。 


使 您 的 开发 更 有 效率 


A 
Fk 


直 运 行 着 。 


B.7 B5 EA aA ISSMSIH E 


:的 一 个 有 用 的 诀窍 就 是 在 开发 过 程 中 一 直 使 Android 模 拟 器 处 于 运行 状 
不 要 关闭 和 重启 它 。 因 为 模拟 器 启动 要 花费 时 间 ， 当 您 在 调试 应 用 程序 时 ， 最 好 让 它 一 


使 用 Eclipse 中 可 用 的 Dalvik Debug Monitor Service(DDMS) 工 具 或 者 Telnet 客 户 靖 ， 可 以 模拟 


发 送 SMS 消 息 到 Android 模 拟 器 。 


pkgmgr /iu:"TelnetClient" 


注意 : Telnet $ P 357 Windows 7 的 默认 安装 项 。 要 安装 它 
Windows 命 令 提 示 符 下 输入 以 下 命令 行 : 


， 可 在 
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键盘 快捷 键 


Android 模 拟 器 支持 多 个 键盘 快捷 键 ,可 以 使 您 模仿 一 个 真正 手机 的 行为 。 以 下 列表 展示 
了 可 与 模拟 器 一 起 使 用 的 一 组 快捷 键 : 

6 Esc iA Te] 
Home 一 一 主屏 幕 
F2 一 一 切换 上 下 文敏 感 菜单 
F3 一 一 通话 记录 
F4 一 一 锁 住 键盘 
F5— Rk 
F8 一 一 切换 数据 网 络 (3G) 
Ctrl+F5 一 一 提高 铃声 音量 
Ctrl+F6 一 一 降低 铃声 音量 
CtrltF11/CtrltF12 一 一 切换 方向 


例如 , 通过 按 下 Ctrl+F11 组 合 键 ， FEIER A EN 


i 55544rdroid 2.2 Emulator 


图 B-21 


现在 看 一 看 在 Telnet 中 如 何 做 到 这 一 点 。 上 自 先 ， 确 保 Android 模 拟 器 正在 运行 。 为 了 Telnet 到 
模拟 堪 ， 需 要 知道 模拟 器 的 病 口 号 。 这 可 以 通过 得 看 Android 模 拟 器 窗口 的 标题 栏 获得 。 冰 口号 
通常 以 5554 开 始 ， 每 一 个 后 续 模 拟 器 的 端口 号 以 2 递增 ， 例 如 5556、5558 等 。 假 定 当 前 有 一 个 
Android 模 拟 器 在 运行 ， 那 么 可 以 使 用 以 下 命令 Telnet 到 它 上 而: 

C:\telnet localhost 5554 
要 给 模拟 器 发 送 一 条 SMS 消 息 ， 可 使 用 以 下 命令 : 


sms send -65123456/ Hello my friend! 
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sms send 命 令 的 语法 如 下 所 示 : 
sms send <phone number> <message> 


图 B-22 展 示 了 模拟 器 正在 接收 刚刚 发 送 的 SMS 消 奶 。 
除了 使 用 Telnet 发 送 SMS 消 息 之 外 ， 还 可 使 用 Eclipse 中 的 DDMS 透 视图 。 如 果 DDMS 透 视图 
在 Eclipse 中 没有 显示 ， 可 以 单 击 Open Perspective 按 钮 (如 图 B-23 所 示 ) 并 选择 Other。 


d 5554: Android 2.2 Emulator E 


Ed «651234567: Hello my friend! 


EL D E 2 


4 Em lelnet localhost G à; Lai 


a - il 
Android Console: type 'help' for a list of commands 


ni send «651234567 Hello my friend! 


Debug 


Java Browsing 


See all your apps. - 
Tauch the Launcher ico 


JavaScript 


Other... 


图 B-22 图 B-23 


XE FEDDMS32 H Ed C FTB-24P 7) FGTOK ZEH 

DDMS 透 视图 显示 之 后 ， 就 可 以 看 到 Devices 选 项 卡 ， 里 面 显示 了 当前 正在 运行 的 模拟 器 
的 列表 。 选 择 一 个 打算 癌 其 发 送 SMS 消 明 的 模拟 器 实例 ， 在 Emulator Control 选 项 卡 的 下 面 ， 将 
看 到 Telephony Actions 部 分 。 在 Incoming number 字 段 中 ， 输 入 一 个 任意 号 个 并 选中 SMS 单 选 按 
钮 。 输 入 一 条 消 县 并 单 击 Send 按 钮 。 


DDMS - Eclipse T 
Eile Edit Run Navigate Search Project Refactor Window | 
zh 84d «65 
Name 
BÀ emulator-5554 Online 
system process 60 
]p.co.omronsoft.open 110 
com.android.phone — 115 
com.android.launche 118 
com.android.settings 121 
android.process.acore 159 
com.android.alarmclc 165 
com.android.music — 178 
com.android.quickse: 186 


uu Üpen Perspective 


CNS Repository Exploring 
GB Database Debug 

fr Database Development 
m DDMS 

5 Debug 

起! lava 


| |: 


ds Java Browsing 

TÈ Java EE (default) 

ta? Jawa Type Hierarchy 

& JavaScript 

H JPA 

ME Planning 

4» Plug-in Development 
m Remote System Explorer 
Resource 


EP Team Synchronizing 
A Weh 


com.android.protips 195 
android.process.medi 203 
com.android.mms — 214 
com.android.email — 230 


FE Baig ta TO 时 * —C 


Telephony Status 
Sl — — Mh —— 


Telephony Actions 
Incoming number «651234567 

2 Voice 

@ SMS 

er Hello my friend] 


Hang Up 


图 B-25 


367 


368 


Android 编 程 入 门 经 典 


现在 ， 选 中 的 模拟 器 将 收 到 一 条 传 入 的 SMS 消 县 。 

如 果 同 时 有 多 个 AVD 运 行 ， 可 以 使 用 模拟 器 的 端口 号 作为 电话 号 码 在 每 一 个 AVD 之 间 发 送 
SMS 消 息 。 例 如 ， 如 果 您 有 分 别 运 行 在 端口 号 5554 和 5556 上 的 两 个 模拟 器 ， 它 们 的 电话 号 码 将 
分 别 是 5554 和 5556。 


B.8 打 电 话 


除了 发 送 SMS 消 息 到 模拟 器 ， 还 可 以 使 用 Telnet 客 户 端 给 模拟 器 打 电 话 。 直 接 使 用 以 下 命令 
就 可 以 做 到 这 一 点 。 
要 Telnet 到 模拟 器 ， 使 用 下 列 命 令 : 
C:\telnet localhost 5554 
要 给 模拟 器 打 电 话 ， 使 用 下 列 命令 : 
gsm call +651234567 


gsm send 命 令 的 语法 如 下 所 示 : 


gsm call «phone number» 


图 B-26 展 示 了 模拟 器 收 到 一 个 呼 入 的 电话 。 

同样 地 ， 也 可 以 使 用 DDMS 透 视图 来 给 模拟 器 打 电 话 。 图 B-27 展 示 了 如 何 使 用 Telephony 
Actions 部 分 来 打 电 话 。 

与 发 送 SMS 一 样 ， 还 可 以 使 用 端口 号 作为 电话 号 码 在 AVD 之 间 打 电话 。 


File Edit Run Navigate Search Project Refactor Window Help 
ri~ m i E EL a E 
EEEE EEC 
Name 


EJ emulataor-5554 Online Android ... 
system process 50 8600 


而 555d4amdroid 22 Emulator 


J]p.co.omronsoft.open 110 


com.android.phone — 115 
com.android.launche 118 
G mji =E (b com.android.settings 1271 
Emul: »ntro xi NI 
al 
C 4( IP Telephony Status 


Hndr oid SEA TEE TER E a list WUGEUVEWRE Telephony Actions 
Incoming number: 651224567 - | 


ER Telnet iocslhest 


Li 
gsm call +65312345967 
Ti 

LT 


Oh 


Hello my friend! 


图 B-26 图 B-27 
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B.9 “从 模拟 器 中 传 入 /出 文件 


偶尔 ， 您 也 许 需要 从 模拟 右 中 传 入 /出 文件 。 使 用 DDMS 透 视图 是 最 容 匈 的 方法 。 从 DDMS 
透视 图 中 选择 模拟 器 (或 者 设备 ， 如 果 您 有 一 个 连接 到 计算 机 的 真实 的 Android 设 备 的 话 ) 并 单 击 
File Explorer 选 项 卡 来 得 看 它 的 文件 系统 (如 岁 B-28 所 示 )。 


8) DDMS - Eclipse x 
Ele Edit Run Navigate Search Project Refactor Window Help 


Big 1Q-:249-i8-- EEIE ES [ij DDMS | 
aO Threads Allocation Tracker | 里 —" 


Size Date 

g emulator-5554 Ünline lata 2010-11-19 
system process 0 in 2010-11-19 
]p.co.omronsoft.open 110 ipi 2010-11-30 
com.android.phone — 115 imi net.learn2develop.AdditionalViews-2.apk 13174 2010-11-29 
com.android.launche 118 ici net.learn2develop.BasicViewsl -2.apk 15438 2010-11-29 
com.android.settings. 121 ii net.learn2develop.Gallery-1.apk 193505 2010-11-30 
android.process.acore 159 i net.learn2develop.Grid-2.apk 192897 2010-11-29 

ml i net.learn2develop.ImageSwritcher-2.apk 193437 2010-11-29 

i net.learn2develop.Menus-1.apk 14363 2010-11-29 
igi net.learn2develop.SendSMSL ab-1.apk 14359 2010-11-30 
RI Status i net.learn2develop.WebView-2.apk 14061 2010-11-29 


+ Be | D EE backup 
It Latency: mji b [59 dalvik-cache 


4 (= data 
E anrirreri.t 


B Emulator Control ND 


图 B-28 
图 B-28 中 显示 的 两 个 按钮 可 用 于 从 模拟 器 中 拖 出 或 回 模拟 器 中 拖 入 一 个 文件 。 
或 者 ， 还 可 以 使 用 Android SD 玉 目 市 的 adb.exe 实 用 工具 来 从 模拟 器 中 拖 出 或 拖 入 文件 。 和 
emulator.exe— FF, ix^ L H4v T«Android SDK Folder>\tools\ 文 i W 
要 从 已 连接 的 模拟 器 /设备 上 复制 文件 到 计算 机 上 ， 可 使 用 以 下 命令 


adb.exe pull /data/app/<filename> c:\ 


注意 : 当 使 用 adb.exe 工 具 从 模拟 器 中 拖 出 或 拖 入 文件 时 ， 确 保 只 有 一 个 
AVD 在 运行 。 


ER COMndeowsicesterm3 Aerden muc 


D:xXBndroid ?.?*xandroid-sdk-windows*stoaolz5adb.ese pull /data/app/net.learn?develo 
p. Äddi tionalliews 2.apk 


ESO 
1169 KB/s (13174 bytes in A. Alls} 


D:XBndroid ?.?*xandroid-sdk-windouws*stoaols?a 


图 B-29 
要 将 文件 复制 到 已 连接 的 模拟 器 /设备 上 ， 可 使 用 以 下 命令 ; 


adb.exe push NOTICE.txt /data/app 


上 面 的 命令 复制 了 位 于 当前 目录 下 的 NOTICE.txt 文 件 ， 并 将 其 保存 在 模拟 器 的 /data/app 文 件 
夹 下 (如 图 B-30 所 示 )。 
如 果 需 要 在 模拟 器 中 修改 文件 的 权限 ， 可 以 使 用 带 有 shell 选 项 的 adb.exe 工 具 ， 如 下 所 示 : 


adb.exe shell 
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图 B-31 展 示 了 如 何 利用 chmod 命 令 修改 NOTICE.txt 文 件 的 权限 。 


Refactor Window Help 
Qu Te 7 tE uo cp oT 


iai net.learn2develop.AcditionalViews-2.apk 
ifi net.learn2develop.BasicViewsl-2.apk 
iai net.learn2develop.Gallery-1.apk 
ii net.learn2develop.Grid-2.apk 
im net.learn2develop.ImageSwitcher-2.apk 
de net.learn2develop.Menus-1.apk 
imi net.learn2develop.SendSMSLab-1.apk 
igi net.learn2develop.WebView-2.apk 

b [Ez app-private 

pb [Ez backup 


图 B-30 


Sze Date 


2010-11-19 


13174 2010-11-29 
15438 2010-11-29 
193505 2010-11-30 
192897 2010-11-29 
193437 2010-11-29 
14363 2010-11-29 
14359 2010-11-30 
14061 2010-11-29 

2010-11-18 
2010-11-18 


ER CoMündowsssysterrn32scmad.exe - adb.exe shell 


D:sBündroid 2.2Xandroid-sdk-windows*tools2adb.exe shell 
# cd data/app 

cd data/app 

+ pwd 


pwd 

/data/app 

# chmod 7/7 NOTICE. txt 
S: Zf? NOTICE. txt 


图 B-31 


使 用 adb.exe 工 具 ， 可 以 对 Android 模 拟 器 发 出 Unix 命 令 。 


B.10” 重 置 模拟 器 


所 有 部 普 到 Android 横 拟 需 上 的 应 用 程序 和 文件 都 保存 在 一 个 名 为 userdata-qemu.img 的 文件 
中 ， 此 文件 位 于 C:\Users\<username>\.android\avd\<avd name>.avd 文 件 夹 下 。 例 如 ， 我 有 一 个 
名 为 Android_ 2.2 Emulator 的 AVD， 因 此 userdata-gemu.img 文 件 束 位 于 C:\Users\Wei-Meng Lee. 


android\avd\Android 2.2 Enwmlator.avd 文 件 夹 下 。 


如 果 想 将 模拟 器 恢复 到 初始 状态 (也 即 重 置 )， 只 要 删 除 userdata-qemu.img 文件 就 行 了 。 


3/0 


Z& 2] CAE 


本 附录 包括 了 各 章节 最 后 的 练习 的 答案 。 


C.1 BIRER 


1. AVD 指 的 是 Android 虚 拟 设 备 。 它 代表 了 一 个 Android 模 拟 嚣 ， 可 以 模拟 一 个 实际 Android 设 
备 的 特定 配置 。 

2. android:versionCode 属 性 用 来 以 编程 方式 检查 一 个 应 用 程序 是 否 可 以 被 升级 。 它 应 当 包 含 一 
个 顺序 号 (更 新 的 应 用 程序 的 号 码 应 该 比 老 版 本 的 设置 得 要 局)。android:versionName 属 性 主 
要 用 来 显示 给 用 户 。 它 是 一 个 字符 串 ， 如 1.0.1。 

3. ”string.xml 文 件 用 来 存储 应 用 程序 中 的 所 有 字符 串 和 常量 。 这 使 得 您 可 以 很 容易 地 通过 巷 换 这 
些 字符 串 并 重新 编译 应 用 程序 来 本 地 化 您 的 应 用 程序 。 


C.2 B2: 7E 


1. ”Android 操 作 系 统 将 显示 一 个 对 话 框 ， 用 户 可 以 从 中 选择 他 们 想 使 用 的 那 一 个 活动 。 


Intent i = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 


startActivity (i); 


3. 在 意图 算 选 器 中 ， 可 以 指定 以 下 内 容 : 动作 、 数 据 、 类 型 和 类 别 。 

4. Toast 类 用 来 癌 用 户 显示 警报 ， 并 在 几 秒 钟 后 消失 。NotificationManager 类 用 来 在 设备 的 状 
态 栏 上 显示 通知 。 由 NotificationManager 类 显示 的 稳 报 是 持久 性 的 ， 只 能 通过 用 户 的 选中 操 
作 来 撤销 。 
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C.3 第 3 章 答案 


1. 


dp 单位 是 与 密度 无 关 的 ，160dp 相 当 于 1 英寸 。px 单 位 对 应 于 屏幕 上 的 实际 像素 。 一 般 应 
当 使 用 dp 单位 ， 因 为 它 可 以 使 活动 在 不 同 屏 才 大 小 的 设备 上 都 可 以 正确 地 缩放 。 

随 着 不 同 屏幕 大 小 的 设备 的 出 现 ， 使 用 AbsoluteLayonut 使 得 您 的 应 用 程序 在 跨 设备 应 用 时 
很 难保 持 一 致 的 外 观 和 体验 。 

当 一 个 活动 被 终止 或 转 入 后 人 台 时 ， 将 触发 onPause(0) 事 件 。onSavelInstanceState() 事 件 与 
onPause(0) 事 件 关 似 ， 除 了 它 不 总 是 被 调用 ， 例 如 当 用 户 按 下 Back 按 钮 来 终止 活动 时 。 

3 个 事件 是 onPause()、onSavelInstanceState() 和 onRetainNonConfigurationInstance()。 


C.4 第 4 章 答案 


1. 
2. 
3. 


应 该 检验 每 一 个 RadioButton 的 isChecked0 方 法 来 确定 其 是 否 被 选中 。 
可 以 使 用 getResources0 〇 方法 。 
以 下 代码 片段 用 于 获取 当前 日 期 : 

//--- 获 取 当 前 日 期 --- 


Calendar today = Calendar.getInstance(); 
yr = today.get (Calendar.YEAR); 

month = today.getí(Calendar.MONTH); 

day = today.get(Calendar.DAY OF MONTH); 
showDialog(DATE DIALOG ID); 


C.5 第 5 章 答 案 


1. 


E 


ImageSwitcher 相 以 使 图 像 动 画 显示 。 您 可 以 在 图 像 显 示 时 以 及 被 男 一 幅 图 像 蔡 换 时 动画 显 
不 它 。 

册 个 方法 是 onCreateOptionsMenu() 和 onOptionsItemSelected()。 

两 个 方法 是 onCreateContextMenu0 和 onContextItemSelected0O)。 

要 防止 司 动 设备 的 Web 浏 览 句 ， 需 要 实现 WebViewClient 类 并 重 写 shouldOverrideUrl- 
Loading) FIE- 


C.6 第 6 章 答案 


1. 


HU c ACVETE — T INLHTEEP BS PUR RE a A R AFE E E MAET Vj 
问 。 

方法 名 称 是 getExternalStorageDirectory()。 

权限 是 WRITE_EXTERNAL STORAGE. 


附录 C JER 


C.7 "BIEN 


1: 


代码 如 下 所 示 : 


Cursor c = managedQuery( 
allContacts, 
projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE ?", 
new String[] [("$jacks$"] , 
ContactsContract.Contacts.DISPLAY NAME + " ASC"); 


JiikjiégetType(. onCreate(). query(). insert(). delete()fllupdate(). 
代码 如 下 所 示 : 


«provider android:name-"BooksProvider" 
android:authorities-"net.learn2develop.provider.Books" /» 


C.8 第 8 章 答 案 


1. 


nf EA UA Zu fe Jj AMA Android) Hd fg PARXESMSYTÉ E. t nf AAMAR NLUS FH VECES 
Messaging 应 用 程序 来 友 送 SMS 信 息 。 

两 个 权限 是 SEND_SMS 和 RECEIVE_SMS 。 

广播 接收 者 应 该 触发 一 个 将 由 活动 接收 的 新 意图 。 活 动 应 该 实现 另 一 个 BroadcastReceiver 来 
侦 听 这 个 新 的 意图 。 

权限 是 INTERNET。 


C.9 第 9 章 答 案 


可 能 的 原因 如 下 所 示 : 

e 没有 Internet 连 接 

€ <uses-library> 元 素 在 AndroidManifest.xml 文 件 中 的 位 置 错误 

€ AndroidManifest.xml 文 件 中 缺少 INTERNET 权 限 

地 理 编码 是 将 一 个 地 址 转换 成 其 坐标 (经 度 和 纬度 )。 反 回 地 理 编 但 是 将 一 对 位 置 坐 标 转换 
成 一 个 地 址 。 

两 个 位 置 服务 提供 商 如 下 所 示 : 

e LocationManager.GPS PROVIDER 

e IocaüonManager.NEIWORK PROVIDER 

方法 是 addProximityAlert()。 


C.10 第 10 章 答案 


1. 


这 是 因为 服务 和 主 调 活动 运行 在 同一 个 进程 上 。 如 果 服 务 是 长 时 间 运 行 的 ， 那 么 需要 在 一 
个 单独 的 线程 上 运行 它 ， 这 样 才 不 会 阻 窗 活 动 。 
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2. IntentService 类 与 Service 类 相似 ， 除 了 前 者 在 一 个 单独 的 线程 上 运行 任务 ， 并 且 当 任务 结束 
执行 时 可 以 自动 停止 服务 。 

3. ”3 个 方法 是 doInBackeground()、onProgressUpdate() 和 onPostExecute()。 

4. 服务 可 以 广播 一 个 意图 ， 而 活动 可 以 使 用 一 个 IntentFilter 类 来 注册 一 个 意图 。 


C.11 第 11 章 答案 
1. 在 AndroidManifest.xml 文 件 中 使 用 minSdkVersion 属 性 来 指定 所 需 的 Android 最 低 版 本 。 


2. ”可 以 使 用 Java SDK 的 keytool.exe 实 用 工具 ， 也 可 以 使 用 Eclipse 的 Export 功 能 来 生成 证 书 。 
3. 转 到 Settings 应 用 程序 并 选择 Application 项 。 选 中 Unknown sources 项 。 
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